@elevenlabs/elevenlabs-js 2.2.0 → 2.4.0

package/api/resources/textToSoundEffects/client/Client.d.ts

@@ -4,7 +4,6 @@
 import * as environments from "../../../../environments";
 import * as core from "../../../../core";
 import * as ElevenLabs from "../../../index";
-import * as stream from "stream";
 export declare namespace TextToSoundEffects {
     interface Options {
         environment?: core.Supplier<environments.ElevenLabsEnvironment | environments.ElevenLabsEnvironmentUrls>;
@@ -12,6 +11,8 @@ export declare namespace TextToSoundEffects {
         baseUrl?: core.Supplier<string>;
         /** Override the xi-api-key header */
         apiKey?: core.Supplier<string | undefined>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
     interface RequestOptions {
         /** The maximum time to wait for a response in seconds. */
@@ -23,7 +24,7 @@ export declare namespace TextToSoundEffects {
         /** Override the xi-api-key header */
         apiKey?: string | undefined;
         /** Additional headers to include in the request. */
-        headers?: Record<string, string>;
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
 }
 export declare class TextToSoundEffects {
@@ -33,6 +34,6 @@ export declare class TextToSoundEffects {
      * Turn text into sound effects for your videos, voice-overs or video games using the most advanced sound effects model in the world.
      * @throws {@link ElevenLabs.UnprocessableEntityError}
      */
-    convert(request: ElevenLabs.CreateSoundEffectRequest, requestOptions?: TextToSoundEffects.RequestOptions): core.HttpResponsePromise<stream.Readable>;
+    convert(request: ElevenLabs.CreateSoundEffectRequest, requestOptions?: TextToSoundEffects.RequestOptions): core.HttpResponsePromise<ReadableStream<Uint8Array>>;
     private __convert;
 }

package/api/resources/textToSoundEffects/client/Client.js

@@ -64,6 +64,7 @@ const environments = __importStar(require("../../../../environments"));
 const core = __importStar(require("../../../../core"));
 const ElevenLabs = __importStar(require("../../../index"));
 const serializers = __importStar(require("../../../../serialization/index"));
+const headers_js_1 = require("../../../../core/headers.js");
 const url_join_1 = __importDefault(require("url-join"));
 const errors = __importStar(require("../../../../errors/index"));
 class TextToSoundEffects {
@@ -79,7 +80,7 @@ class TextToSoundEffects {
     }
     __convert(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             const { outputFormat } = request, _body = __rest(request, ["outputFormat"]);
             const _queryParams = {};
             if (outputFormat != null) {
@@ -88,9 +89,7 @@ class TextToSoundEffects {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, "v1/sound-generation"),
                 method: "POST",
-                headers: Object.assign({ "xi-api-key": (yield core.Supplier.get(this._options.apiKey)) != null
-                        ? yield core.Supplier.get(this._options.apiKey)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@elevenlabs/elevenlabs-js", "X-Fern-SDK-Version": "v2.2.0", "User-Agent": "@elevenlabs/elevenlabs-js/v2.2.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",

package/api/resources/textToSoundEffects/client/index.d.ts

@@ -1 +1,2 @@
+export {};
 export * from "./requests";

package/api/resources/textToSpeech/client/Client.d.ts

@@ -4,7 +4,6 @@
 import * as environments from "../../../../environments";
 import * as core from "../../../../core";
 import * as ElevenLabs from "../../../index";
-import * as stream from "stream";
 export declare namespace TextToSpeech {
     interface Options {
         environment?: core.Supplier<environments.ElevenLabsEnvironment | environments.ElevenLabsEnvironmentUrls>;
@@ -12,6 +11,8 @@ export declare namespace TextToSpeech {
         baseUrl?: core.Supplier<string>;
         /** Override the xi-api-key header */
         apiKey?: core.Supplier<string | undefined>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
     interface RequestOptions {
         /** The maximum time to wait for a response in seconds. */
@@ -23,7 +24,7 @@ export declare namespace TextToSpeech {
         /** Override the xi-api-key header */
         apiKey?: string | undefined;
         /** Additional headers to include in the request. */
-        headers?: Record<string, string>;
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
 }
 export declare class TextToSpeech {
@@ -33,7 +34,7 @@ export declare class TextToSpeech {
      * Converts text into speech using a voice of your choice and returns audio.
      * @throws {@link ElevenLabs.UnprocessableEntityError}
      */
-    convert(voiceId: string, request: ElevenLabs.TextToSpeechRequest, requestOptions?: TextToSpeech.RequestOptions): core.HttpResponsePromise<stream.Readable>;
+    convert(voiceId: string, request: ElevenLabs.TextToSpeechRequest, requestOptions?: TextToSpeech.RequestOptions): core.HttpResponsePromise<ReadableStream<Uint8Array>>;
     private __convert;
     /**
      * Generate speech from text with precise character-level timing information for audio-text synchronization.
@@ -55,7 +56,7 @@ export declare class TextToSpeech {
      * Converts text into speech using a voice of your choice and returns audio as an audio stream.
      * @throws {@link ElevenLabs.UnprocessableEntityError}
      */
-    stream(voiceId: string, request: ElevenLabs.StreamTextToSpeechRequest, requestOptions?: TextToSpeech.RequestOptions): core.HttpResponsePromise<stream.Readable>;
+    stream(voiceId: string, request: ElevenLabs.StreamTextToSpeechRequest, requestOptions?: TextToSpeech.RequestOptions): core.HttpResponsePromise<ReadableStream<Uint8Array>>;
     private __stream;
     /**
      * Converts text into speech using a voice of your choice and returns a stream of JSONs containing audio as a base64 encoded string together with information on when which character was spoken.

package/api/resources/textToSpeech/client/Client.js

@@ -64,6 +64,7 @@ const environments = __importStar(require("../../../../environments"));
 const core = __importStar(require("../../../../core"));
 const ElevenLabs = __importStar(require("../../../index"));
 const serializers = __importStar(require("../../../../serialization/index"));
+const headers_js_1 = require("../../../../core/headers.js");
 const url_join_1 = __importDefault(require("url-join"));
 const errors = __importStar(require("../../../../errors/index"));
 class TextToSpeech {
@@ -79,7 +80,7 @@ class TextToSpeech {
     }
     __convert(voiceId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             const { enableLogging, optimizeStreamingLatency, outputFormat } = request, _body = __rest(request, ["enableLogging", "optimizeStreamingLatency", "outputFormat"]);
             const _queryParams = {};
             if (enableLogging != null) {
@@ -94,9 +95,7 @@ class TextToSpeech {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, `v1/text-to-speech/${encodeURIComponent(voiceId)}`),
                 method: "POST",
-                headers: Object.assign({ "xi-api-key": (yield core.Supplier.get(this._options.apiKey)) != null
-                        ? yield core.Supplier.get(this._options.apiKey)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@elevenlabs/elevenlabs-js", "X-Fern-SDK-Version": "v2.2.0", "User-Agent": "@elevenlabs/elevenlabs-js/v2.2.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",
@@ -162,7 +161,7 @@ class TextToSpeech {
     }
     __convertWithTimestamps(voiceId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             const { enableLogging, optimizeStreamingLatency, outputFormat } = request, _body = __rest(request, ["enableLogging", "optimizeStreamingLatency", "outputFormat"]);
             const _queryParams = {};
             if (enableLogging != null) {
@@ -180,9 +179,7 @@ class TextToSpeech {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, `v1/text-to-speech/${encodeURIComponent(voiceId)}/with-timestamps`),
                 method: "POST",
-                headers: Object.assign({ "xi-api-key": (yield core.Supplier.get(this._options.apiKey)) != null
-                        ? yield core.Supplier.get(this._options.apiKey)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@elevenlabs/elevenlabs-js", "X-Fern-SDK-Version": "v2.2.0", "User-Agent": "@elevenlabs/elevenlabs-js/v2.2.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",
@@ -245,7 +242,7 @@ class TextToSpeech {
     }
     __stream(voiceId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             const { enableLogging, optimizeStreamingLatency, outputFormat } = request, _body = __rest(request, ["enableLogging", "optimizeStreamingLatency", "outputFormat"]);
             const _queryParams = {};
             if (enableLogging != null) {
@@ -260,9 +257,7 @@ class TextToSpeech {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, `v1/text-to-speech/${encodeURIComponent(voiceId)}/stream`),
                 method: "POST",
-                headers: Object.assign({ "xi-api-key": (yield core.Supplier.get(this._options.apiKey)) != null
-                        ? yield core.Supplier.get(this._options.apiKey)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@elevenlabs/elevenlabs-js", "X-Fern-SDK-Version": "v2.2.0", "User-Agent": "@elevenlabs/elevenlabs-js/v2.2.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",
@@ -317,7 +312,7 @@ class TextToSpeech {
     }
     __streamWithTimestamps(voiceId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             const { enableLogging, optimizeStreamingLatency, outputFormat } = request, _body = __rest(request, ["enableLogging", "optimizeStreamingLatency", "outputFormat"]);
             const _queryParams = {};
             if (enableLogging != null) {
@@ -332,9 +327,7 @@ class TextToSpeech {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, `v1/text-to-speech/${encodeURIComponent(voiceId)}/stream/with-timestamps`),
                 method: "POST",
-                headers: Object.assign({ "xi-api-key": (yield core.Supplier.get(this._options.apiKey)) != null
-                        ? yield core.Supplier.get(this._options.apiKey)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@elevenlabs/elevenlabs-js", "X-Fern-SDK-Version": "v2.2.0", "User-Agent": "@elevenlabs/elevenlabs-js/v2.2.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",

package/api/resources/textToSpeech/client/index.d.ts

@@ -1 +1,2 @@
+export {};
 export * from "./requests";

package/api/resources/textToVoice/client/Client.d.ts

@@ -11,6 +11,8 @@ export declare namespace TextToVoice {
         baseUrl?: core.Supplier<string>;
         /** Override the xi-api-key header */
         apiKey?: core.Supplier<string | undefined>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
     interface RequestOptions {
         /** The maximum time to wait for a response in seconds. */
@@ -22,7 +24,7 @@ export declare namespace TextToVoice {
         /** Override the xi-api-key header */
         apiKey?: string | undefined;
         /** Additional headers to include in the request. */
-        headers?: Record<string, string>;
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
 }
 export declare class TextToVoice {
@@ -60,4 +62,36 @@ export declare class TextToVoice {
      */
     createVoiceFromPreview(request: ElevenLabs.SaveVoicePreviewRequest, requestOptions?: TextToVoice.RequestOptions): core.HttpResponsePromise<ElevenLabs.Voice>;
     private __createVoiceFromPreview;
+    /**
+     * Create a voice from previously generated voice preview. This endpoint should be called after you fetched a generated_voice_id using POST /v1/text-to-voice/design or POST /v1/text-to-voice/:voice_id/remix.
+     *
+     * @param {ElevenLabs.BodyCreateANewVoiceFromVoicePreviewV1TextToVoicePost} request
+     * @param {TextToVoice.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link ElevenLabs.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.textToVoice.create({
+     *         voiceName: "Sassy squeaky mouse",
+     *         voiceDescription: "A sassy squeaky mouse",
+     *         generatedVoiceId: "37HceQefKmEi3bGovXjL"
+     *     })
+     */
+    create(request: ElevenLabs.BodyCreateANewVoiceFromVoicePreviewV1TextToVoicePost, requestOptions?: TextToVoice.RequestOptions): core.HttpResponsePromise<ElevenLabs.Voice>;
+    private __create;
+    /**
+     * Design a voice via a prompt. This method returns a list of voice previews. Each preview has a generated_voice_id and a sample of the voice as base64 encoded mp3 audio. To create a voice use the generated_voice_id of the preferred preview with the /v1/text-to-voice endpoint.
+     *
+     * @param {ElevenLabs.VoiceDesignRequestModel} request
+     * @param {TextToVoice.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link ElevenLabs.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.textToVoice.design({
+     *         voiceDescription: "A sassy squeaky mouse"
+     *     })
+     */
+    design(request: ElevenLabs.VoiceDesignRequestModel, requestOptions?: TextToVoice.RequestOptions): core.HttpResponsePromise<ElevenLabs.VoiceDesignPreviewResponse>;
+    private __design;
 }

package/api/resources/textToVoice/client/Client.js

@@ -64,6 +64,7 @@ const environments = __importStar(require("../../../../environments"));
 const core = __importStar(require("../../../../core"));
 const ElevenLabs = __importStar(require("../../../index"));
 const serializers = __importStar(require("../../../../serialization/index"));
+const headers_js_1 = require("../../../../core/headers.js");
 const url_join_1 = __importDefault(require("url-join"));
 const errors = __importStar(require("../../../../errors/index"));
 class TextToVoice {
@@ -88,7 +89,7 @@ class TextToVoice {
     }
     __createPreviews(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             const { outputFormat } = request, _body = __rest(request, ["outputFormat"]);
             const _queryParams = {};
             if (outputFormat != null) {
@@ -97,9 +98,7 @@ class TextToVoice {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, "v1/text-to-voice/create-previews"),
                 method: "POST",
-                headers: Object.assign({ "xi-api-key": (yield core.Supplier.get(this._options.apiKey)) != null
-                        ? yield core.Supplier.get(this._options.apiKey)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@elevenlabs/elevenlabs-js", "X-Fern-SDK-Version": "v2.2.0", "User-Agent": "@elevenlabs/elevenlabs-js/v2.2.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",
@@ -173,13 +172,11 @@ class TextToVoice {
     }
     __createVoiceFromPreview(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, "v1/text-to-voice/create-voice-from-preview"),
                 method: "POST",
-                headers: Object.assign({ "xi-api-key": (yield core.Supplier.get(this._options.apiKey)) != null
-                        ? yield core.Supplier.get(this._options.apiKey)
-                        : undefined, "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@elevenlabs/elevenlabs-js", "X-Fern-SDK-Version": "v2.2.0", "User-Agent": "@elevenlabs/elevenlabs-js/v2.2.0", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.SaveVoicePreviewRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -232,5 +229,167 @@ class TextToVoice {
             }
         });
     }
+    /**
+     * Create a voice from previously generated voice preview. This endpoint should be called after you fetched a generated_voice_id using POST /v1/text-to-voice/design or POST /v1/text-to-voice/:voice_id/remix.
+     *
+     * @param {ElevenLabs.BodyCreateANewVoiceFromVoicePreviewV1TextToVoicePost} request
+     * @param {TextToVoice.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link ElevenLabs.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.textToVoice.create({
+     *         voiceName: "Sassy squeaky mouse",
+     *         voiceDescription: "A sassy squeaky mouse",
+     *         generatedVoiceId: "37HceQefKmEi3bGovXjL"
+     *     })
+     */
+    create(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
+    }
+    __create(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const _response = yield core.fetcher({
+                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, "v1/text-to-voice"),
+                method: "POST",
+                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.BodyCreateANewVoiceFromVoicePreviewV1TextToVoicePost.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 240000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.Voice.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new ElevenLabs.UnprocessableEntityError(serializers.HttpValidationError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.ElevenLabsError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.ElevenLabsError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.ElevenLabsTimeoutError("Timeout exceeded when calling POST /v1/text-to-voice.");
+                case "unknown":
+                    throw new errors.ElevenLabsError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Design a voice via a prompt. This method returns a list of voice previews. Each preview has a generated_voice_id and a sample of the voice as base64 encoded mp3 audio. To create a voice use the generated_voice_id of the preferred preview with the /v1/text-to-voice endpoint.
+     *
+     * @param {ElevenLabs.VoiceDesignRequestModel} request
+     * @param {TextToVoice.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link ElevenLabs.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.textToVoice.design({
+     *         voiceDescription: "A sassy squeaky mouse"
+     *     })
+     */
+    design(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__design(request, requestOptions));
+    }
+    __design(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const { outputFormat } = request, _body = __rest(request, ["outputFormat"]);
+            const _queryParams = {};
+            if (outputFormat != null) {
+                _queryParams["output_format"] = serializers.TextToVoiceDesignRequestOutputFormat.jsonOrThrow(outputFormat, {
+                    unrecognizedObjectKeys: "strip",
+                });
+            }
+            const _response = yield core.fetcher({
+                url: (0, url_join_1.default)((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ElevenLabsEnvironment.Production).base, "v1/text-to-voice/design"),
+                method: "POST",
+                headers: (0, headers_js_1.mergeHeaders)((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "xi-api-key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.apiKey }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                queryParameters: _queryParams,
+                requestType: "json",
+                body: serializers.VoiceDesignRequestModel.jsonOrThrow(_body, { unrecognizedObjectKeys: "strip" }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 240000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.VoiceDesignPreviewResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new ElevenLabs.UnprocessableEntityError(serializers.HttpValidationError.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.ElevenLabsError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.ElevenLabsError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.ElevenLabsTimeoutError("Timeout exceeded when calling POST /v1/text-to-voice/design.");
+                case "unknown":
+                    throw new errors.ElevenLabsError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }
 exports.TextToVoice = TextToVoice;

package/api/resources/textToVoice/client/index.d.ts

@@ -1 +1,2 @@
+export {};
 export * from "./requests";

package/api/resources/textToVoice/client/requests/BodyCreateANewVoiceFromVoicePreviewV1TextToVoicePost.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         voiceName: "Sassy squeaky mouse",
+ *         voiceDescription: "A sassy squeaky mouse",
+ *         generatedVoiceId: "37HceQefKmEi3bGovXjL"
+ *     }
+ */
+export interface BodyCreateANewVoiceFromVoicePreviewV1TextToVoicePost {
+    /** Name to use for the created voice. */
+    voiceName: string;
+    /** Description to use for the created voice. */
+    voiceDescription: string;
+    /** The generated_voice_id to create, call POST /v1/text-to-voice/create-previews and fetch the generated_voice_id from the response header if don't have one yet. */
+    generatedVoiceId: string;
+    /** Optional, metadata to add to the created voice. Defaults to None. */
+    labels?: Record<string, string | undefined>;
+    /** List of voice ids that the user has played but not selected. Used for RLHF. */
+    playedNotSelectedVoiceIds?: string[];
+}

package/api/resources/textToVoice/client/requests/VoiceDesignRequestModel.d.ts

@@ -0,0 +1,36 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as ElevenLabs from "../../../../index";
+/**
+ * @example
+ *     {
+ *         voiceDescription: "A sassy squeaky mouse"
+ *     }
+ */
+export interface VoiceDesignRequestModel {
+    /**
+     * Output format of the generated audio. Formatted as codec_sample_rate_bitrate. So an mp3 with 22.05kHz sample rate at 32kbs is represented as mp3_22050_32. MP3 with 192kbps bitrate requires you to be subscribed to Creator tier or above. PCM with 44.1kHz sample rate requires you to be subscribed to Pro tier or above. Note that the μ-law format (sometimes written mu-law, often approximated as u-law) is commonly used for Twilio audio inputs.
+     */
+    outputFormat?: ElevenLabs.TextToVoiceDesignRequestOutputFormat;
+    /** Description to use for the created voice. */
+    voiceDescription: string;
+    /** Model to use for the voice generation. Possible values: eleven_multilingual_ttv_v2, eleven_ttv_v3. */
+    modelId?: ElevenLabs.VoiceDesignRequestModelModelId;
+    /** Text to generate, text length has to be between 100 and 1000. */
+    text?: string;
+    /** Whether to automatically generate a text suitable for the voice description. */
+    autoGenerateText?: boolean;
+    /** Controls the volume level of the generated voice. -1 is quietest, 1 is loudest, 0 corresponds to roughly -24 LUFS. */
+    loudness?: number;
+    /** Random number that controls the voice generation. Same seed with same inputs produces same voice. */
+    seed?: number;
+    /** Controls how closely the AI follows the prompt. Lower numbers give the AI more freedom to be creative, while higher numbers force it to stick more to the prompt. High numbers can cause voice to sound artificial or robotic. We recommend to use longer, more detailed prompts at lower Guidance Scale. */
+    guidanceScale?: number;
+    /** Higher quality results in better voice output but less variety. */
+    quality?: number;
+    /** Reference audio to use for the voice generation. The audio should be base64 encoded. Only supported when using the  eleven_ttv_v3 model. */
+    referenceAudioBase64?: string;
+    /** Controls the balance of prompt versus reference audio when generating voice samples. 0 means almost no prompt influence, 1 means almost no reference audio influence. Only supported when using the eleven_ttv_v3 model and providing reference audio. */
+    promptStrength?: number;
+}

package/api/resources/textToVoice/client/requests/index.d.ts

@@ -1,2 +1,4 @@
 export { type VoiceDesignRequest } from "./VoiceDesignRequest";
 export { type SaveVoicePreviewRequest } from "./SaveVoicePreviewRequest";
+export { type BodyCreateANewVoiceFromVoicePreviewV1TextToVoicePost } from "./BodyCreateANewVoiceFromVoicePreviewV1TextToVoicePost";
+export { type VoiceDesignRequestModel } from "./VoiceDesignRequestModel";

package/api/resources/textToVoice/types/TextToVoiceDesignRequestOutputFormat.d.ts

@@ -0,0 +1,28 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Output format of the generated audio. Formatted as codec_sample_rate_bitrate. So an mp3 with 22.05kHz sample rate at 32kbs is represented as mp3_22050_32. MP3 with 192kbps bitrate requires you to be subscribed to Creator tier or above. PCM with 44.1kHz sample rate requires you to be subscribed to Pro tier or above. Note that the μ-law format (sometimes written mu-law, often approximated as u-law) is commonly used for Twilio audio inputs.
+ */
+export type TextToVoiceDesignRequestOutputFormat = "mp3_22050_32" | "mp3_44100_32" | "mp3_44100_64" | "mp3_44100_96" | "mp3_44100_128" | "mp3_44100_192" | "pcm_8000" | "pcm_16000" | "pcm_22050" | "pcm_24000" | "pcm_44100" | "pcm_48000" | "ulaw_8000" | "alaw_8000" | "opus_48000_32" | "opus_48000_64" | "opus_48000_96" | "opus_48000_128" | "opus_48000_192";
+export declare const TextToVoiceDesignRequestOutputFormat: {
+    readonly Mp32205032: "mp3_22050_32";
+    readonly Mp34410032: "mp3_44100_32";
+    readonly Mp34410064: "mp3_44100_64";
+    readonly Mp34410096: "mp3_44100_96";
+    readonly Mp344100128: "mp3_44100_128";
+    readonly Mp344100192: "mp3_44100_192";
+    readonly Pcm8000: "pcm_8000";
+    readonly Pcm16000: "pcm_16000";
+    readonly Pcm22050: "pcm_22050";
+    readonly Pcm24000: "pcm_24000";
+    readonly Pcm44100: "pcm_44100";
+    readonly Pcm48000: "pcm_48000";
+    readonly Ulaw8000: "ulaw_8000";
+    readonly Alaw8000: "alaw_8000";
+    readonly Opus4800032: "opus_48000_32";
+    readonly Opus4800064: "opus_48000_64";
+    readonly Opus4800096: "opus_48000_96";
+    readonly Opus48000128: "opus_48000_128";
+    readonly Opus48000192: "opus_48000_192";
+};

package/api/resources/textToVoice/types/TextToVoiceDesignRequestOutputFormat.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextToVoiceDesignRequestOutputFormat = void 0;
+exports.TextToVoiceDesignRequestOutputFormat = {
+    Mp32205032: "mp3_22050_32",
+    Mp34410032: "mp3_44100_32",
+    Mp34410064: "mp3_44100_64",
+    Mp34410096: "mp3_44100_96",
+    Mp344100128: "mp3_44100_128",
+    Mp344100192: "mp3_44100_192",
+    Pcm8000: "pcm_8000",
+    Pcm16000: "pcm_16000",
+    Pcm22050: "pcm_22050",
+    Pcm24000: "pcm_24000",
+    Pcm44100: "pcm_44100",
+    Pcm48000: "pcm_48000",
+    Ulaw8000: "ulaw_8000",
+    Alaw8000: "alaw_8000",
+    Opus4800032: "opus_48000_32",
+    Opus4800064: "opus_48000_64",
+    Opus4800096: "opus_48000_96",
+    Opus48000128: "opus_48000_128",
+    Opus48000192: "opus_48000_192",
+};

package/api/resources/textToVoice/types/VoiceDesignRequestModelModelId.d.ts

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Model to use for the voice generation. Possible values: eleven_multilingual_ttv_v2, eleven_ttv_v3.
+ */
+export type VoiceDesignRequestModelModelId = "eleven_multilingual_ttv_v2" | "eleven_ttv_v3";
+export declare const VoiceDesignRequestModelModelId: {
+    readonly ElevenMultilingualTtvV2: "eleven_multilingual_ttv_v2";
+    readonly ElevenTtvV3: "eleven_ttv_v3";
+};

package/api/resources/textToVoice/types/VoiceDesignRequestModelModelId.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoiceDesignRequestModelModelId = void 0;
+exports.VoiceDesignRequestModelModelId = {
+    ElevenMultilingualTtvV2: "eleven_multilingual_ttv_v2",
+    ElevenTtvV3: "eleven_ttv_v3",
+};

package/api/resources/textToVoice/types/index.d.ts

@@ -1 +1,3 @@
 export * from "./TextToVoiceCreatePreviewsRequestOutputFormat";
+export * from "./TextToVoiceDesignRequestOutputFormat";
+export * from "./VoiceDesignRequestModelModelId";