import { APIResource } from "../core/resource.js";
import { APIPromise } from "../core/api-promise.js";
import { CursorPage, type CursorPageParams, PagePromise } from "../core/pagination.js";
import { RequestOptions } from "../internal/request-options.js";
export declare class Voices extends APIResource {
    /**
     * Create a custom voice from a text description, or clone a voice from an audio
     * sample.
     */
    create(body: VoiceCreateParams, options?: RequestOptions): APIPromise<VoiceCreateResponse>;
    /**
     * Get details about a specific custom voice.
     */
    retrieve(id: string, options?: RequestOptions): APIPromise<VoiceRetrieveResponse>;
    /**
     * List custom voices for the authenticated organization with cursor-based
     * pagination.
     */
    list(query: VoiceListParams, options?: RequestOptions): PagePromise<VoiceListResponsesCursorPage, VoiceListResponse>;
    /**
     * Delete a custom voice.
     */
    delete(id: string, options?: RequestOptions): APIPromise<void>;
    /**
     * Generate a short audio preview of a voice from a text description. Use this to
     * audition a voice before creating it.
     */
    preview(body: VoicePreviewParams, options?: RequestOptions): APIPromise<VoicePreviewResponse>;
}
export type VoiceListResponsesCursorPage = CursorPage<VoiceListResponse>;
export interface VoiceCreateResponse {
    /**
     * The ID of the voice that was created.
     */
    id: string;
}
/**
 * A voice that is still being processed.
 */
export type VoiceRetrieveResponse = VoiceRetrieveResponse.Processing | VoiceRetrieveResponse.Ready | VoiceRetrieveResponse.Failed;
export declare namespace VoiceRetrieveResponse {
    /**
     * A voice that is still being processed.
     */
    interface Processing {
        /**
         * The unique identifier of the voice.
         */
        id: string;
        /**
         * When the voice was created.
         */
        createdAt: string;
        /**
         * A description of the voice, or null if not set.
         */
        description: string | null;
        /**
         * The name of the voice.
         */
        name: string;
        status: 'PROCESSING';
    }
    /**
     * A voice that is ready for use.
     */
    interface Ready {
        /**
         * The unique identifier of the voice.
         */
        id: string;
        /**
         * When the voice was created.
         */
        createdAt: string;
        /**
         * A description of the voice, or null if not set.
         */
        description: string | null;
        /**
         * The name of the voice.
         */
        name: string;
        /**
         * A signed URL to an MP3 audio sample of the voice, or null if no sample is
         * available.
         */
        previewUrl: string | null;
        status: 'READY';
    }
    /**
     * A voice that failed to finish processing.
     */
    interface Failed {
        /**
         * The unique identifier of the voice.
         */
        id: string;
        /**
         * When the voice was created.
         */
        createdAt: string;
        /**
         * A description of the voice, or null if not set.
         */
        description: string | null;
        /**
         * A human-readable error message. This value is not stable and should not be
         * matched against programmatically.
         */
        failureReason: string;
        /**
         * The name of the voice.
         */
        name: string;
        status: 'FAILED';
    }
}
/**
 * A voice that is still being processed.
 */
export type VoiceListResponse = VoiceListResponse.Processing | VoiceListResponse.Ready | VoiceListResponse.Failed;
export declare namespace VoiceListResponse {
    /**
     * A voice that is still being processed.
     */
    interface Processing {
        /**
         * The unique identifier of the voice.
         */
        id: string;
        /**
         * When the voice was created.
         */
        createdAt: string;
        /**
         * A description of the voice, or null if not set.
         */
        description: string | null;
        /**
         * The name of the voice.
         */
        name: string;
        status: 'PROCESSING';
    }
    /**
     * A voice that is ready for use.
     */
    interface Ready {
        /**
         * The unique identifier of the voice.
         */
        id: string;
        /**
         * When the voice was created.
         */
        createdAt: string;
        /**
         * A description of the voice, or null if not set.
         */
        description: string | null;
        /**
         * The name of the voice.
         */
        name: string;
        /**
         * A signed URL to an MP3 audio sample of the voice, or null if no sample is
         * available.
         */
        previewUrl: string | null;
        status: 'READY';
    }
    /**
     * A voice that failed to finish processing.
     */
    interface Failed {
        /**
         * The unique identifier of the voice.
         */
        id: string;
        /**
         * When the voice was created.
         */
        createdAt: string;
        /**
         * A description of the voice, or null if not set.
         */
        description: string | null;
        /**
         * A human-readable error message. This value is not stable and should not be
         * matched against programmatically.
         */
        failureReason: string;
        /**
         * The name of the voice.
         */
        name: string;
        status: 'FAILED';
    }
}
export interface VoicePreviewResponse {
    /**
     * Duration of the audio preview in seconds.
     */
    durationSecs: number;
    /**
     * A presigned URL to the audio preview. The URL expires after 24 hours.
     */
    url: string;
}
export interface VoiceCreateParams {
    from: VoiceCreateParams.Audio | VoiceCreateParams.Text;
    /**
     * A name for the voice.
     */
    name: string;
    /**
     * An optional description of the voice.
     */
    description?: string | null;
}
export declare namespace VoiceCreateParams {
    interface Audio {
        /**
         * A HTTPS URL.
         */
        audio: string;
        type: 'audio';
    }
    interface Text {
        /**
         * The voice design model to use. Prefer eleven_ttv_v3 (latest);
         * eleven_multilingual_ttv_v2 is the previous generation.
         */
        model: 'eleven_ttv_v3' | 'eleven_multilingual_ttv_v2';
        /**
         * A text description of the desired voice characteristics. Must be at least 20
         * characters.
         */
        prompt: string;
        type: 'text';
    }
}
export interface VoiceListParams extends CursorPageParams {
}
export interface VoicePreviewParams {
    /**
     * The voice design model to use. Prefer eleven_ttv_v3 (latest);
     * eleven_multilingual_ttv_v2 is the previous generation.
     */
    model: 'eleven_ttv_v3' | 'eleven_multilingual_ttv_v2';
    /**
     * A text description of the desired voice characteristics. Must be at least 20
     * characters.
     */
    prompt: string;
}
export declare namespace Voices {
    export { type VoiceCreateResponse as VoiceCreateResponse, type VoiceRetrieveResponse as VoiceRetrieveResponse, type VoiceListResponse as VoiceListResponse, type VoicePreviewResponse as VoicePreviewResponse, type VoiceListResponsesCursorPage as VoiceListResponsesCursorPage, type VoiceCreateParams as VoiceCreateParams, type VoiceListParams as VoiceListParams, type VoicePreviewParams as VoicePreviewParams, };
}
//# sourceMappingURL=voices.d.ts.map