@cartesia/cartesia-js 2.1.4 → 2.1.6

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

@@ -18,13 +18,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : 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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __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) {
@@ -55,12 +65,12 @@ class Voices {
      *     await client.voices.list()
      */
     list(requestOptions) {
-        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
             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, "/voices/"),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/"),
                 method: "GET",
-                headers: 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.1.4", "User-Agent": "@cartesia/cartesia-js/2.1.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign(Object.assign({ "Cartesia-Version": (_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.cartesiaVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.cartesiaVersion) !== null && _f !== void 0 ? _f : "2024-06-10", "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@cartesia/cartesia-js", "X-Fern-SDK-Version": "2.1.6", "User-Agent": "@cartesia/cartesia-js/2.1.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -89,7 +99,7 @@ class Voices {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling GET /voices/.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -98,33 +108,64 @@ class Voices {
         });
     }
     /**
-     * @param {Cartesia.CreateVoiceRequest} request
+     * 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.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"
+     *     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
      *     })
      */
-    create(request, requestOptions) {
-        var _a, _b, _c, _d, _e;
+    clone(clip, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
+            const _request = yield core.newFormData();
+            yield _request.appendFile("clip", clip);
+            _request.append("name", request.name);
+            if (request.description != null) {
+                _request.append("description", request.description);
+            }
+            _request.append("language", serializers.SupportedLanguage.jsonOrThrow(request.language, { unrecognizedObjectKeys: "strip" }));
+            _request.append("mode", serializers.CloneMode.jsonOrThrow(request.mode, { unrecognizedObjectKeys: "strip" }));
+            _request.append("enhance", request.enhance.toString());
+            if (request.transcript != null) {
+                _request.append("transcript", request.transcript);
+            }
+            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, "/voices/"),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/clone"),
                 method: "POST",
-                headers: 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.1.4", "User-Agent": "@cartesia/cartesia-js/2.1.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
-                contentType: "application/json",
-                requestType: "json",
-                body: serializers.CreateVoiceRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                headers: Object.assign(Object.assign(Object.assign({ "Cartesia-Version": (_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.cartesiaVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.cartesiaVersion) !== null && _f !== void 0 ? _f : "2024-06-10", "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@cartesia/cartesia-js", "X-Fern-SDK-Version": "2.1.6", "User-Agent": "@cartesia/cartesia-js/2.1.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), _maybeEncodedRequest.headers), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                requestType: "file",
+                duplex: _maybeEncodedRequest.duplex,
+                body: _maybeEncodedRequest.body,
                 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 serializers.Voice.parseOrThrow(_response.body, {
+                return serializers.VoiceMetadata.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -145,7 +186,7 @@ class Voices {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /voices/clone.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -158,15 +199,15 @@ class Voices {
      * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
-     *     await client.voices.delete("string")
+     *     await client.voices.delete("id")
      */
     delete(id, requestOptions) {
-        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
             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, `/voices/${encodeURIComponent(serializers.VoiceId.jsonOrThrow(id))}`),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, `/voices/${encodeURIComponent(serializers.VoiceId.jsonOrThrow(id))}`),
                 method: "DELETE",
-                headers: 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.1.4", "User-Agent": "@cartesia/cartesia-js/2.1.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign(Object.assign({ "Cartesia-Version": (_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.cartesiaVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.cartesiaVersion) !== null && _f !== void 0 ? _f : "2024-06-10", "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@cartesia/cartesia-js", "X-Fern-SDK-Version": "2.1.6", "User-Agent": "@cartesia/cartesia-js/2.1.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -189,7 +230,7 @@ class Voices {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling DELETE /voices/{id}.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -203,18 +244,18 @@ class Voices {
      * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
-     *     await client.voices.update("string", {
-     *         name: "string",
-     *         description: "string"
+     *     await client.voices.update("id", {
+     *         name: "name",
+     *         description: "description"
      *     })
      */
     update(id, request, requestOptions) {
-        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
             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, `/voices/${encodeURIComponent(serializers.VoiceId.jsonOrThrow(id))}`),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, `/voices/${encodeURIComponent(serializers.VoiceId.jsonOrThrow(id))}`),
                 method: "PATCH",
-                headers: 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.1.4", "User-Agent": "@cartesia/cartesia-js/2.1.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign(Object.assign({ "Cartesia-Version": (_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.cartesiaVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.cartesiaVersion) !== null && _f !== void 0 ? _f : "2024-06-10", "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@cartesia/cartesia-js", "X-Fern-SDK-Version": "2.1.6", "User-Agent": "@cartesia/cartesia-js/2.1.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.UpdateVoiceRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -244,7 +285,7 @@ class Voices {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling PATCH /voices/{id}.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -257,15 +298,15 @@ class Voices {
      * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
-     *     await client.voices.get("string")
+     *     await client.voices.get("id")
      */
     get(id, requestOptions) {
-        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
             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, `/voices/${encodeURIComponent(serializers.VoiceId.jsonOrThrow(id))}`),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, `/voices/${encodeURIComponent(serializers.VoiceId.jsonOrThrow(id))}`),
                 method: "GET",
-                headers: 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.1.4", "User-Agent": "@cartesia/cartesia-js/2.1.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign(Object.assign({ "Cartesia-Version": (_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.cartesiaVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.cartesiaVersion) !== null && _f !== void 0 ? _f : "2024-06-10", "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@cartesia/cartesia-js", "X-Fern-SDK-Version": "2.1.6", "User-Agent": "@cartesia/cartesia-js/2.1.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -294,7 +335,7 @@ class Voices {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling GET /voices/{id}.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -308,19 +349,19 @@ class Voices {
      *
      * @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],
+     *         embedding: [1.1, 1.1],
      *         language: "en",
      *         originalSpeakerGender: "male",
-     *         dialect: "au"
+     *         dialect: undefined
      *     })
      */
     localize(request, requestOptions) {
-        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
             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, "/voices/localize"),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/localize"),
                 method: "POST",
-                headers: 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.1.4", "User-Agent": "@cartesia/cartesia-js/2.1.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign(Object.assign({ "Cartesia-Version": (_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.cartesiaVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.cartesiaVersion) !== null && _f !== void 0 ? _f : "2024-06-10", "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@cartesia/cartesia-js", "X-Fern-SDK-Version": "2.1.6", "User-Agent": "@cartesia/cartesia-js/2.1.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.LocalizeVoiceRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -350,7 +391,7 @@ class Voices {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /voices/localize.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -365,18 +406,21 @@ class Voices {
      * @example
      *     await client.voices.mix({
      *         voices: [{
-     *                 id: "string",
+     *                 id: "id",
+     *                 weight: 1.1
+     *             }, {
+     *                 id: "id",
      *                 weight: 1.1
      *             }]
      *     })
      */
     mix(request, requestOptions) {
-        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
             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, "/voices/mix"),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/mix"),
                 method: "POST",
-                headers: 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.1.4", "User-Agent": "@cartesia/cartesia-js/2.1.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign(Object.assign({ "Cartesia-Version": (_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.cartesiaVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.cartesiaVersion) !== null && _f !== void 0 ? _f : "2024-06-10", "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@cartesia/cartesia-js", "X-Fern-SDK-Version": "2.1.6", "User-Agent": "@cartesia/cartesia-js/2.1.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.MixVoicesRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -406,7 +450,7 @@ class Voices {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /voices/mix.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -415,64 +459,36 @@ class Voices {
         });
     }
     /**
-     * Clone a voice from an audio clip. This endpoint has two modes, stability and similarity.
+     * Create voice from raw features. If you'd like to clone a voice from an audio file, please use Clone Voice instead.
      *
-     * 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 {Cartesia.CreateVoiceRequest} 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",
+     *     await client.voices.create({
+     *         name: "My Custom Voice",
+     *         description: "A custom voice created through the API",
+     *         embedding: [],
      *         language: "en",
-     *         transcript: "A transcript of the words spoken in the audio clip.",
-     *         enhance: false
+     *         baseVoiceId: "123e4567-e89b-12d3-a456-426614174000"
      *     })
      */
-    clone(clip, request, requestOptions) {
-        var _a, _b, _c, _d, _e;
+    create(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            const _request = yield core.newFormData();
-            yield _request.appendFile("clip", clip);
-            yield _request.append("name", request.name);
-            if (request.description != null) {
-                yield _request.append("description", request.description);
-            }
-            yield _request.append("language", request.language);
-            yield _request.append("mode", request.mode);
-            yield _request.append("enhance", request.enhance.toString());
-            if (request.transcript != null) {
-                yield _request.append("transcript", request.transcript);
-            }
-            const _maybeEncodedRequest = yield _request.getRequest();
+            var _a, _b, _c, _d, _e, _f;
             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, "/voices/clone"),
+                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/"),
                 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.1.4", "User-Agent": "@cartesia/cartesia-js/2.1.4", "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,
+                headers: Object.assign(Object.assign({ "Cartesia-Version": (_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.cartesiaVersion) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.cartesiaVersion) !== null && _f !== void 0 ? _f : "2024-06-10", "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "@cartesia/cartesia-js", "X-Fern-SDK-Version": "2.1.6", "User-Agent": "@cartesia/cartesia-js/2.1.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.CreateVoiceRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
                 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 serializers.VoiceMetadata.parseOrThrow(_response.body, {
+                return serializers.Voice.parseOrThrow(_response.body, {
                     unrecognizedObjectKeys: "passthrough",
                     allowUnrecognizedUnionMembers: true,
                     allowUnrecognizedEnumValues: true,
@@ -493,7 +509,7 @@ class Voices {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /voices/.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,

package/api/resources/voices/types/BaseVoiceId.d.ts

@@ -3,6 +3,6 @@
  */
 import * as Cartesia from "../../../index";
 /**
- * The ID of the base voice associated with the voice, used for features like voice mixing.
+ * Pull in features from a base voice, used for features like voice mixing.
  */
-export declare type BaseVoiceId = Cartesia.VoiceId;
+export type BaseVoiceId = Cartesia.VoiceId;

package/api/resources/voices/types/CloneMode.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export declare type CloneMode = "similarity" | "stability";
+export type CloneMode = "similarity" | "stability";
 export declare const CloneMode: {
     readonly Similarity: "similarity";
     readonly Stability: "stability";

package/api/resources/voices/types/CreateVoiceRequest.d.ts

@@ -9,4 +9,5 @@ export interface CreateVoiceRequest {
     description: string;
     embedding: Cartesia.Embedding;
     language?: Cartesia.SupportedLanguage;
+    baseVoiceId?: Cartesia.BaseVoiceId;
 }

package/api/resources/voices/types/Gender.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export declare type Gender = "male" | "female";
+export type Gender = "male" | "female";
 export declare const Gender: {
     readonly Male: "male";
     readonly Female: "female";

package/api/resources/voices/types/LocalizeDialect.d.ts

@@ -3,10 +3,18 @@
  */
 import * as Cartesia from "../../../index";
 /**
- * The dialect to localize to. Only supported for English (`en`).
+ * The dialect to localize to. Only supported for English (`en`), Spanish (`es`), and Portuguese (`pt`).
  */
-export declare type LocalizeDialect = 
+export type LocalizeDialect = 
 /**
- * Only available when language is set to English (`en`).
+ * Only available when language is set to English (`en`). Options: Australian (`au`), Indian (`in`), Southern (`so`), British (`uk`), or American (`us`).
  *  */
-Cartesia.LocalizeEnglishDialect;
+Cartesia.LocalizeEnglishDialect
+/**
+ * Only available when language is set to Spanish (`es`). Options: Mexican (`mx`) and Peninsular (`pe`).
+ *  */
+ | Cartesia.LocalizeSpanishDialect
+/**
+ * Only available when language is set to Portuguese (`pt`). Options: Brazilian (`br`) and European Portuguese (`eu`).
+ *  */
+ | Cartesia.LocalizePortugueseDialect;

package/api/resources/voices/types/LocalizeEnglishDialect.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export declare type LocalizeEnglishDialect = "au" | "in" | "so" | "uk" | "us";
+export type LocalizeEnglishDialect = "au" | "in" | "so" | "uk" | "us";
 export declare const LocalizeEnglishDialect: {
     readonly Au: "au";
     readonly In: "in";

package/api/resources/voices/types/LocalizePortugueseDialect.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type LocalizePortugueseDialect = "br" | "eu";
+export declare const LocalizePortugueseDialect: {
+    readonly Br: "br";
+    readonly Eu: "eu";
+};

package/api/resources/voices/types/LocalizePortugueseDialect.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.LocalizePortugueseDialect = void 0;
+exports.LocalizePortugueseDialect = {
+    Br: "br",
+    Eu: "eu",
+};

package/api/resources/voices/types/LocalizeSpanishDialect.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type LocalizeSpanishDialect = "mx" | "pe";
+export declare const LocalizeSpanishDialect: {
+    readonly Mx: "mx";
+    readonly Pe: "pe";
+};

package/api/resources/voices/types/LocalizeSpanishDialect.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.LocalizeSpanishDialect = void 0;
+exports.LocalizeSpanishDialect = {
+    Mx: "mx",
+    Pe: "pe",
+};

package/api/resources/voices/types/LocalizeTargetLanguage.d.ts

@@ -6,7 +6,7 @@
  *
  * Options: English (en), German (de), Spanish (es), French (fr), Japanese (ja), Portuguese (pt), Chinese (zh), Hindi (hi), Italian (it), Korean (ko), Dutch (nl), Polish (pl), Russian (ru), Swedish (sv), Turkish (tr).
  */
-export declare type LocalizeTargetLanguage = "en" | "de" | "es" | "fr" | "ja" | "pt" | "zh" | "hi" | "it" | "ko" | "nl" | "pl" | "ru" | "sv" | "tr";
+export type LocalizeTargetLanguage = "en" | "de" | "es" | "fr" | "ja" | "pt" | "zh" | "hi" | "it" | "ko" | "nl" | "pl" | "ru" | "sv" | "tr";
 export declare const LocalizeTargetLanguage: {
     readonly En: "en";
     readonly De: "de";

package/api/resources/voices/types/MixVoiceSpecifier.d.ts

@@ -2,4 +2,4 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as Cartesia from "../../../index";
-export declare type MixVoiceSpecifier = Cartesia.IdSpecifier | Cartesia.EmbeddingSpecifier;
+export type MixVoiceSpecifier = Cartesia.IdSpecifier | Cartesia.EmbeddingSpecifier;

package/api/resources/voices/types/VoiceId.d.ts

@@ -4,4 +4,4 @@
 /**
  * The ID of the voice.
  */
-export declare type VoiceId = string;
+export type VoiceId = string;

package/api/resources/voices/types/Weight.d.ts

@@ -4,4 +4,4 @@
 /**
  * The weight of the voice or embedding in the mix. If weights do not sum to 1, they will be normalized.
  */
-export declare type Weight = number;
+export type Weight = number;

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

@@ -6,6 +6,8 @@ export * from "./CreateVoiceRequest";
 export * from "./UpdateVoiceRequest";
 export * from "./LocalizeTargetLanguage";
 export * from "./LocalizeEnglishDialect";
+export * from "./LocalizeSpanishDialect";
+export * from "./LocalizePortugueseDialect";
 export * from "./LocalizeDialect";
 export * from "./Gender";
 export * from "./LocalizeVoiceRequest";

package/api/resources/voices/types/index.js

@@ -22,6 +22,8 @@ __exportStar(require("./CreateVoiceRequest"), exports);
 __exportStar(require("./UpdateVoiceRequest"), exports);
 __exportStar(require("./LocalizeTargetLanguage"), exports);
 __exportStar(require("./LocalizeEnglishDialect"), exports);
+__exportStar(require("./LocalizeSpanishDialect"), exports);
+__exportStar(require("./LocalizePortugueseDialect"), exports);
 __exportStar(require("./LocalizeDialect"), exports);
 __exportStar(require("./Gender"), exports);
 __exportStar(require("./LocalizeVoiceRequest"), exports);

package/core/fetcher/APIResponse.d.ts

@@ -1,4 +1,4 @@
-export declare type APIResponse<Success, Failure> = SuccessfulResponse<Success> | FailedResponse<Failure>;
+export type APIResponse<Success, Failure> = SuccessfulResponse<Success> | FailedResponse<Failure>;
 export interface SuccessfulResponse<T> {
     ok: true;
     body: T;

package/core/fetcher/Fetcher.d.ts

@@ -1,5 +1,5 @@
 import { APIResponse } from "./APIResponse";
-export declare type FetchFunction = <R = unknown>(args: Fetcher.Args) => Promise<APIResponse<R, Fetcher.Error>>;
+export type FetchFunction = <R = unknown>(args: Fetcher.Args) => Promise<APIResponse<R, Fetcher.Error>>;
 export declare namespace Fetcher {
     interface Args {
         url: string;

package/core/fetcher/Fetcher.js

@@ -9,7 +9,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetcher = exports.fetcherImpl = void 0;
+exports.fetcher = void 0;
+exports.fetcherImpl = fetcherImpl;
 const createRequestUrl_1 = require("./createRequestUrl");
 const getFetchFn_1 = require("./getFetchFn");
 const getRequestBody_1 = require("./getRequestBody");
@@ -95,5 +96,4 @@ function fetcherImpl(args) {
         }
     });
 }
-exports.fetcherImpl = fetcherImpl;
 exports.fetcher = fetcherImpl;

package/core/fetcher/Supplier.d.ts

@@ -1,4 +1,4 @@
-export declare type Supplier<T> = T | Promise<T> | (() => T | Promise<T>);
+export type Supplier<T> = T | Promise<T> | (() => T | Promise<T>);
 export declare const Supplier: {
     get: <T>(supplier: Supplier<T>) => Promise<T>;
 };