import { APIResource } from "../core/resource.mjs";
import * as TTSAPI from "./tts.mjs";
import { APIPromise } from "../core/api-promise.mjs";
import { Stream } from "../core/streaming.mjs";
import { type Uploadable } from "../core/uploads.mjs";
import { RequestOptions } from "../internal/request-options.mjs";
export declare class VoiceChanger extends APIResource {
    /**
     * Voice Changer (Bytes).
     *
     * Takes an audio file of speech, and returns an audio file of speech spoken with
     * the same intonation, but with a different voice.
     *
     * This endpoint is priced at 15 characters per second of input audio.
     */
    generate(body: VoiceChangerGenerateParams, options?: RequestOptions): APIPromise<Response>;
    /**
     * Voice Changer (SSE)
     */
    generateSSE(body: VoiceChangerGenerateSSEParams, options?: RequestOptions): APIPromise<Stream<VoiceChangerSSEEvent>>;
    /**
     * Alias of {@link VoiceChanger.generate } for backward compatibility.
     */
    changeVoiceBytes(...args: Parameters<VoiceChanger['generate']>): ReturnType<VoiceChanger['generate']>;
    /**
     * Make a raw Voice Changer (SSE) request without any response handling.
     *
     * @deprecated Use {@link VoiceChanger.generateSSE } for built-in event parsing and streaming.
     */
    changeVoiceSse(body: VoiceChangerGenerateSSEParams, options?: RequestOptions): APIPromise<void>;
}
/**
 * An event emitted by the Voice Changer SSE stream.
 */
export type VoiceChangerSSEEvent = VoiceChangerSSEEvent.VoiceChangerSSEChunk | VoiceChangerSSEEvent.VoiceChangerSSEDone | VoiceChangerSSEEvent.VoiceChangerSSEError;
export declare namespace VoiceChangerSSEEvent {
    /**
     * Audio data chunk.
     */
    interface VoiceChangerSSEChunk {
        /**
         * Base64-encoded audio data.
         */
        data: string;
        /**
         * Whether this is the final event for the request. Always `false` for chunk
         * events.
         */
        done: false;
        /**
         * The sample rate of the audio in Hz.
         */
        sample_rate: number;
        /**
         * HTTP-style status code. Always `206` for chunk events.
         */
        status_code: 206;
        /**
         * Server-side processing time for this chunk in milliseconds.
         */
        step_time: number;
    }
    /**
     * Generation completion signal. Final event in the stream.
     */
    interface VoiceChangerSSEDone {
        /**
         * Whether generation is complete. Always `true` for done events.
         */
        done: true;
        /**
         * HTTP-style status code. Always `200` for done events.
         */
        status_code: 200;
    }
    /**
     * Error information for the Voice Changer SSE request.
     */
    interface VoiceChangerSSEError {
        /**
         * Whether generation is complete. Always `true` for error events.
         */
        done: true;
        /**
         * Human-readable error message.
         */
        message: string;
        /**
         * Unique identifier for this request.
         */
        request_id: string;
        /**
         * An HTTP response status code.
         */
        status_code: number;
        /**
         * Human-readable error title.
         */
        title: string;
        /**
         * Event type identifier.
         */
        type: 'error';
        /**
         * URL to relevant documentation.
         */
        doc_url?: string | null;
        /**
         * Machine-readable error code.
         */
        error_code?: string | null;
    }
}
export interface VoiceChangerGenerateParams {
    clip?: Uploadable;
    /**
     * Required for `mp3` containers.
     */
    'output_format[bit_rate]'?: number | null;
    'output_format[container]'?: TTSAPI.OutputFormatContainer;
    /**
     * Required for `raw` and `wav` containers.
     */
    'output_format[encoding]'?: TTSAPI.RawEncoding | null;
    'output_format[sample_rate]'?: 8000 | 16000 | 22050 | 24000 | 44100 | 48000;
    'voice[id]'?: string;
}
export interface VoiceChangerGenerateSSEParams {
    clip?: Uploadable;
    /**
     * Required for `mp3` containers.
     */
    'output_format[bit_rate]'?: number | null;
    'output_format[container]'?: TTSAPI.OutputFormatContainer;
    /**
     * Required for `raw` and `wav` containers.
     */
    'output_format[encoding]'?: TTSAPI.RawEncoding | null;
    'output_format[sample_rate]'?: 8000 | 16000 | 22050 | 24000 | 44100 | 48000;
    'voice[id]'?: string;
}
/** Type alias for backward compatibility */
export type VoiceChangerChangeVoiceBytesParams = VoiceChangerGenerateParams;
/** Type alias for backward compatibility */
export type VoiceChangerChangeVoiceSseParams = VoiceChangerGenerateSSEParams;
export declare namespace VoiceChanger {
    export { type VoiceChangerSSEEvent as VoiceChangerSSEEvent, type VoiceChangerChangeVoiceBytesParams as VoiceChangerChangeVoiceBytesParams, type VoiceChangerChangeVoiceSseParams as VoiceChangerChangeVoiceSseParams, type VoiceChangerGenerateParams as VoiceChangerGenerateParams, type VoiceChangerGenerateSSEParams as VoiceChangerGenerateSSEParams, };
}
//# sourceMappingURL=voice-changer.d.mts.map