@cartesia/cartesia-js 1.3.0 → 2.0.0-alpha

package/dist/api/resources/tts/types/index.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ContextId"), exports);
+__exportStar(require("./WebSocketBaseResponse"), exports);
+__exportStar(require("./WebSocketResponse"), exports);
+__exportStar(require("./WebSocketErrorResponse"), exports);
+__exportStar(require("./WebSocketChunkResponse"), exports);
+__exportStar(require("./WebSocketTimestampsResponse"), exports);
+__exportStar(require("./WebSocketTtsOutput"), exports);
+__exportStar(require("./WebSocketStreamOptions"), exports);
+__exportStar(require("./WordTimestamps"), exports);
+__exportStar(require("./WebSocketDoneResponse"), exports);
+__exportStar(require("./CancelContextRequest"), exports);
+__exportStar(require("./GenerationRequest"), exports);
+__exportStar(require("./WebSocketRawOutputFormat"), exports);
+__exportStar(require("./WebSocketRequest"), exports);
+__exportStar(require("./WebSocketTtsRequest"), exports);
+__exportStar(require("./TtsRequest"), exports);
+__exportStar(require("./SupportedLanguage"), exports);
+__exportStar(require("./OutputFormat"), exports);
+__exportStar(require("./RawOutputFormat"), exports);
+__exportStar(require("./RawEncoding"), exports);
+__exportStar(require("./WavOutputFormat"), exports);
+__exportStar(require("./Mp3OutputFormat"), exports);
+__exportStar(require("./TtsRequestVoiceSpecifier"), exports);
+__exportStar(require("./TtsRequestIdSpecifier"), exports);
+__exportStar(require("./TtsRequestEmbeddingSpecifier"), exports);
+__exportStar(require("./Controls"), exports);
+__exportStar(require("./Speed"), exports);
+__exportStar(require("./NumericalSpecifier"), exports);
+__exportStar(require("./NaturalSpecifier"), exports);
+__exportStar(require("./Emotion"), exports);

package/dist/api/resources/voiceChanger/client/Client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/// <reference types="node" />
+import * as environments from "../../../../environments";
+import * as core from "../../../../core";
+import * as fs from "fs";
+import { Blob } from "buffer";
+import * as Cartesia from "../../../index";
+import * as stream from "stream";
+export declare namespace VoiceChanger {
+    interface Options {
+        environment?: core.Supplier<environments.CartesiaEnvironment | string>;
+        apiKeyHeader?: core.Supplier<string | undefined>;
+        /** Override the Cartesia-Version header */
+        cartesiaVersion?: "2024-06-10";
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Override the Cartesia-Version header */
+        cartesiaVersion?: "2024-06-10";
+    }
+}
+export declare class VoiceChanger {
+    protected readonly _options: VoiceChanger.Options;
+    constructor(_options?: VoiceChanger.Options);
+    /**
+     * 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.
+     */
+    bytes(clip: File | fs.ReadStream | Blob, request: Cartesia.VoiceChangerBytesRequest, requestOptions?: VoiceChanger.RequestOptions): Promise<stream.Readable>;
+    sse(clip: File | fs.ReadStream | Blob, request: Cartesia.VoiceChangerSseRequest, requestOptions?: VoiceChanger.RequestOptions): Promise<core.Stream<Cartesia.StreamingResponse>>;
+    protected _getCustomAuthorizationHeaders(): Promise<{
+        "X-API-Key": string | undefined;
+    }>;
+}

package/dist/api/resources/voiceChanger/client/Client.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoiceChanger = void 0;
+const environments = __importStar(require("../../../../environments"));
+const core = __importStar(require("../../../../core"));
+const url_join_1 = __importDefault(require("url-join"));
+const errors = __importStar(require("../../../../errors/index"));
+const serializers = __importStar(require("../../../../serialization/index"));
+class VoiceChanger {
+    constructor(_options = {}) {
+        this._options = _options;
+    }
+    /**
+     * 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.
+     */
+    bytes(clip, request, requestOptions) {
+        var _a, _b, _c, _d, _e;
+        return __awaiter(this, void 0, void 0, function* () {
+            const _request = yield core.newFormData();
+            yield _request.appendFile("clip", clip);
+            yield _request.append("voice[id]", request.voiceId);
+            yield _request.append("output_format[container]", request.outputFormatContainer);
+            yield _request.append("output_format[sample_rate]", request.outputFormatSampleRate.toString());
+            if (request.outputFormatEncoding != null) {
+                yield _request.append("output_format[encoding]", request.outputFormatEncoding);
+            }
+            if (request.outputFormatBitRate != null) {
+                yield _request.append("output_format[bit_rate]", request.outputFormatBitRate.toString());
+            }
+            const _maybeEncodedRequest = yield _request.getRequest();
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.CartesiaEnvironment.Production, "/voice-changer/bytes"),
+                method: "POST",
+                headers: Object.assign(Object.assign({ "Cartesia-Version": (_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.cartesiaVersion) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.cartesiaVersion) !== null && _e !== void 0 ? _e : "2024-06-10", "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@cartesia/cartesia-js", "X-Fern-SDK-Version": "2.0.0-alpha", "User-Agent": "@cartesia/cartesia-js/2.0.0-alpha", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), _maybeEncodedRequest.headers),
+                requestType: "file",
+                duplex: _maybeEncodedRequest.duplex,
+                body: _maybeEncodedRequest.body,
+                responseType: "streaming",
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return _response.body;
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.CartesiaError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                });
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.CartesiaError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                    });
+                case "timeout":
+                    throw new errors.CartesiaTimeoutError();
+                case "unknown":
+                    throw new errors.CartesiaError({
+                        message: _response.error.errorMessage,
+                    });
+            }
+        });
+    }
+    sse(clip, request, requestOptions) {
+        var _a, _b, _c, _d, _e;
+        return __awaiter(this, void 0, void 0, function* () {
+            const _request = yield core.newFormData();
+            yield _request.appendFile("clip", clip);
+            yield _request.append("voice[id]", request.voiceId);
+            yield _request.append("output_format[container]", request.outputFormatContainer);
+            yield _request.append("output_format[sample_rate]", request.outputFormatSampleRate.toString());
+            if (request.outputFormatEncoding != null) {
+                yield _request.append("output_format[encoding]", request.outputFormatEncoding);
+            }
+            if (request.outputFormatBitRate != null) {
+                yield _request.append("output_format[bit_rate]", request.outputFormatBitRate.toString());
+            }
+            const _maybeEncodedRequest = yield _request.getRequest();
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.CartesiaEnvironment.Production, "/voice-changer/sse"),
+                method: "POST",
+                headers: Object.assign(Object.assign({ "Cartesia-Version": (_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.cartesiaVersion) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.cartesiaVersion) !== null && _e !== void 0 ? _e : "2024-06-10", "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@cartesia/cartesia-js", "X-Fern-SDK-Version": "2.0.0-alpha", "User-Agent": "@cartesia/cartesia-js/2.0.0-alpha", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), _maybeEncodedRequest.headers),
+                requestType: "file",
+                duplex: _maybeEncodedRequest.duplex,
+                body: _maybeEncodedRequest.body,
+                responseType: "sse",
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return new core.Stream({
+                    stream: _response.body,
+                    parse: (data) => __awaiter(this, void 0, void 0, function* () {
+                        return serializers.StreamingResponse.parseOrThrow(data, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        });
+                    }),
+                    signal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                    eventShape: {
+                        type: "json",
+                        messageTerminator: "\n",
+                    },
+                });
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.CartesiaError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                });
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.CartesiaError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                    });
+                case "timeout":
+                    throw new errors.CartesiaTimeoutError();
+                case "unknown":
+                    throw new errors.CartesiaError({
+                        message: _response.error.errorMessage,
+                    });
+            }
+        });
+    }
+    _getCustomAuthorizationHeaders() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const apiKeyHeaderValue = yield core.Supplier.get(this._options.apiKeyHeader);
+            return { "X-API-Key": apiKeyHeaderValue };
+        });
+    }
+}
+exports.VoiceChanger = VoiceChanger;

package/dist/api/resources/voiceChanger/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests";

package/dist/api/resources/voiceChanger/client/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests"), exports);

package/dist/api/resources/voiceChanger/client/requests/VoiceChangerBytesRequest.d.ts

@@ -0,0 +1,44 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../../index";
+/**
+ * @example
+ *     {
+ *         voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
+ *         outputFormatContainer: "mp3",
+ *         outputFormatSampleRate: 44100,
+ *         outputFormatBitRate: 128000
+ *     }
+ *
+ * @example
+ *     {
+ *         voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
+ *         outputFormatContainer: "wav",
+ *         outputFormatSampleRate: 44100,
+ *         outputFormatEncoding: "pcm_f32le"
+ *     }
+ *
+ * @example
+ *     {
+ *         voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
+ *         outputFormatContainer: "raw",
+ *         outputFormatSampleRate: 44100,
+ *         outputFormatEncoding: "pcm_f32le"
+ *     }
+ */
+export interface VoiceChangerBytesRequest {
+    voiceId: string;
+    outputFormatContainer: Cartesia.OutputFormatContainer;
+    outputFormatSampleRate: number;
+    /**
+     * Required for `raw` and `wav` containers.
+     *
+     */
+    outputFormatEncoding?: Cartesia.RawEncoding;
+    /**
+     * Required for `mp3` containers.
+     *
+     */
+    outputFormatBitRate?: number;
+}

package/dist/api/resources/voiceChanger/client/requests/VoiceChangerBytesRequest.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voiceChanger/client/requests/VoiceChangerSseRequest.d.ts

@@ -0,0 +1,44 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../../index";
+/**
+ * @example
+ *     {
+ *         voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
+ *         outputFormatContainer: "mp3",
+ *         outputFormatSampleRate: 44100,
+ *         outputFormatBitRate: 128000
+ *     }
+ *
+ * @example
+ *     {
+ *         voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
+ *         outputFormatContainer: "wav",
+ *         outputFormatSampleRate: 44100,
+ *         outputFormatEncoding: "pcm_f32le"
+ *     }
+ *
+ * @example
+ *     {
+ *         voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
+ *         outputFormatContainer: "raw",
+ *         outputFormatSampleRate: 44100,
+ *         outputFormatEncoding: "pcm_f32le"
+ *     }
+ */
+export interface VoiceChangerSseRequest {
+    voiceId: string;
+    outputFormatContainer: Cartesia.OutputFormatContainer;
+    outputFormatSampleRate: number;
+    /**
+     * Required for `raw` and `wav` containers.
+     *
+     */
+    outputFormatEncoding?: Cartesia.RawEncoding;
+    /**
+     * Required for `mp3` containers.
+     *
+     */
+    outputFormatBitRate?: number;
+}

package/dist/api/resources/voiceChanger/client/requests/VoiceChangerSseRequest.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voiceChanger/client/requests/index.d.ts

@@ -0,0 +1,2 @@
+export { type VoiceChangerBytesRequest } from "./VoiceChangerBytesRequest";
+export { type VoiceChangerSseRequest } from "./VoiceChangerSseRequest";

package/dist/api/resources/voiceChanger/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voiceChanger/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./client";

package/dist/api/resources/voiceChanger/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./client"), exports);

package/dist/api/resources/voiceChanger/types/OutputFormatContainer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export declare type OutputFormatContainer = "raw" | "wav" | "mp3";
+export declare const OutputFormatContainer: {
+    readonly Raw: "raw";
+    readonly Wav: "wav";
+    readonly Mp3: "mp3";
+};

package/dist/api/resources/voiceChanger/types/OutputFormatContainer.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputFormatContainer = void 0;
+exports.OutputFormatContainer = {
+    Raw: "raw",
+    Wav: "wav",
+    Mp3: "mp3",
+};

package/dist/api/resources/voiceChanger/types/StreamingResponse.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export declare type StreamingResponse = Cartesia.StreamingResponse.Chunk | Cartesia.StreamingResponse.Done | Cartesia.StreamingResponse.Error_;
+export declare namespace StreamingResponse {
+    interface Chunk extends Cartesia.WebSocketChunkResponse {
+        type: "chunk";
+    }
+    interface Done extends Cartesia.WebSocketDoneResponse {
+        type: "done";
+    }
+    interface Error_ extends Cartesia.WebSocketErrorResponse {
+        type: "error";
+    }
+}

package/dist/api/resources/voiceChanger/types/StreamingResponse.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/voiceChanger/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./OutputFormatContainer";
+export * from "./StreamingResponse";

package/dist/api/resources/voiceChanger/types/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./OutputFormatContainer"), exports);
+__exportStar(require("./StreamingResponse"), exports);

package/dist/api/resources/voices/client/Client.d.ts

@@ -0,0 +1,141 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/// <reference types="node" />
+import * as environments from "../../../../environments";
+import * as core from "../../../../core";
+import * as Cartesia from "../../../index";
+import * as fs from "fs";
+import { Blob } from "buffer";
+export declare namespace Voices {
+    interface Options {
+        environment?: core.Supplier<environments.CartesiaEnvironment | string>;
+        apiKeyHeader?: core.Supplier<string | undefined>;
+        /** Override the Cartesia-Version header */
+        cartesiaVersion?: "2024-06-10";
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Override the Cartesia-Version header */
+        cartesiaVersion?: "2024-06-10";
+    }
+}
+export declare class Voices {
+    protected readonly _options: Voices.Options;
+    constructor(_options?: Voices.Options);
+    /**
+     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.voices.list()
+     */
+    list(requestOptions?: Voices.RequestOptions): Promise<Cartesia.Voice[]>;
+    /**
+     * @param {Cartesia.CreateVoiceRequest} request
+     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.voices.create({
+     *         name: "string",
+     *         description: "string",
+     *         embedding: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
+     *         language: "en",
+     *         baseVoiceId: "string"
+     *     })
+     */
+    create(request: Cartesia.CreateVoiceRequest, requestOptions?: Voices.RequestOptions): Promise<Cartesia.Voice>;
+    /**
+     * @param {Cartesia.VoiceId} id
+     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.voices.delete("string")
+     */
+    delete(id: Cartesia.VoiceId, requestOptions?: Voices.RequestOptions): Promise<void>;
+    /**
+     * @param {Cartesia.VoiceId} id
+     * @param {Cartesia.UpdateVoiceRequest} request
+     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.voices.update("string", {
+     *         name: "string",
+     *         description: "string"
+     *     })
+     */
+    update(id: Cartesia.VoiceId, request: Cartesia.UpdateVoiceRequest, requestOptions?: Voices.RequestOptions): Promise<Cartesia.Voice>;
+    /**
+     * @param {Cartesia.VoiceId} id
+     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.voices.get("string")
+     */
+    get(id: Cartesia.VoiceId, requestOptions?: Voices.RequestOptions): Promise<Cartesia.Voice>;
+    /**
+     * @param {Cartesia.LocalizeVoiceRequest} request
+     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.voices.localize({
+     *         embedding: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
+     *         language: "en",
+     *         originalSpeakerGender: "male",
+     *         dialect: "au"
+     *     })
+     */
+    localize(request: Cartesia.LocalizeVoiceRequest, requestOptions?: Voices.RequestOptions): Promise<Cartesia.EmbeddingResponse>;
+    /**
+     * @param {Cartesia.MixVoicesRequest} request
+     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.voices.mix({
+     *         voices: [{
+     *                 id: "string",
+     *                 weight: 1.1
+     *             }]
+     *     })
+     */
+    mix(request: Cartesia.MixVoicesRequest, requestOptions?: Voices.RequestOptions): Promise<Cartesia.EmbeddingResponse>;
+    /**
+     * Clone a voice from an audio clip. This endpoint has two modes, stability and similarity.
+     *
+     * Similarity mode clones are more similar to the source clip, but may reproduce background noise. For these, use an audio clip about 5 seconds long.
+     *
+     * Stability mode clones are more stable, but may not sound as similar to the source clip. For these, use an audio clip 10-20 seconds long.
+     *
+     * @param {File | fs.ReadStream | Blob} clip
+     * @param {Cartesia.CloneVoiceRequest} request
+     * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.voices.clone(fs.createReadStream("/path/to/your/file"), {
+     *         name: "A high-stability cloned voice",
+     *         description: "Copied from Cartesia docs",
+     *         mode: "stability",
+     *         language: "en",
+     *         enhance: true
+     *     })
+     *
+     * @example
+     *     await client.voices.clone(fs.createReadStream("/path/to/your/file"), {
+     *         name: "A high-similarity cloned voice",
+     *         description: "Copied from Cartesia docs",
+     *         mode: "similarity",
+     *         language: "en",
+     *         transcript: "A transcript of the words spoken in the audio clip.",
+     *         enhance: false
+     *     })
+     */
+    clone(clip: File | fs.ReadStream | Blob, request: Cartesia.CloneVoiceRequest, requestOptions?: Voices.RequestOptions): Promise<Cartesia.VoiceMetadata>;
+    protected _getCustomAuthorizationHeaders(): Promise<{
+        "X-API-Key": string | undefined;
+    }>;
+}