@cartesia/cartesia-js 2.1.4 → 2.1.6

package/dist/api/resources/datasets/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 Datasets {
      *     await client.datasets.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, "/datasets/"),
+                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, "/datasets/"),
                 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 Datasets {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling GET /datasets/.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -103,16 +113,16 @@ class Datasets {
      *
      * @example
      *     await client.datasets.create({
-     *         name: "string"
+     *         name: "name"
      *     })
      */
     create(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, "/datasets/"),
+                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, "/datasets/"),
                 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.CreateDatasetRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -142,7 +152,7 @@ class Datasets {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /datasets/.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -155,15 +165,15 @@ class Datasets {
      * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
-     *     await client.datasets.listFiles("string")
+     *     await client.datasets.listFiles("id")
      */
     listFiles(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, `/datasets/${encodeURIComponent(id)}/files`),
+                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, `/datasets/${encodeURIComponent(id)}/files`),
                 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,
@@ -192,7 +202,7 @@ class Datasets {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling GET /datasets/{id}/files.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -205,21 +215,18 @@ class Datasets {
      * @param {string} id
      * @param {Cartesia.UploadDatasetFileRequest} request
      * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @example
-     *     await client.datasets.uploadFile(fs.createReadStream("/path/to/your/file"), "string", {})
      */
     uploadFile(file, 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 _request = yield core.newFormData();
             yield _request.appendFile("file", file);
-            yield _request.append("purpose", request.purpose);
+            _request.append("purpose", serializers.FilePurpose.jsonOrThrow(request.purpose, { unrecognizedObjectKeys: "strip" }));
             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, `/datasets/${encodeURIComponent(id)}/files`),
+                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, `/datasets/${encodeURIComponent(id)}/files`),
                 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),
+                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,
@@ -243,7 +250,7 @@ class Datasets {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /datasets/{id}/files.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,

package/dist/api/resources/datasets/client/requests/UploadDatasetFileRequest.d.ts

@@ -2,10 +2,6 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as Cartesia from "../../../../index";
-/**
- * @example
- *     {}
- */
 export interface UploadDatasetFileRequest {
     purpose: Cartesia.FilePurpose;
 }

package/dist/api/resources/datasets/types/FilePurpose.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export declare type FilePurpose = "fine_tune";
+export type FilePurpose = "fine_tune";
 export declare const FilePurpose: {
     readonly FineTune: "fine_tune";
 };

package/dist/api/resources/embedding/types/Embedding.d.ts

@@ -7,4 +7,4 @@
  * @example
  *     [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1]
  */
-export declare type Embedding = number[];
+export type Embedding = number[];

package/dist/api/resources/index.js

@@ -15,13 +15,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 __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);
 };

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

@@ -1,7 +1,6 @@
 /**
  * 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";
@@ -11,6 +10,8 @@ import * as stream from "stream";
 export declare namespace Infill {
     interface Options {
         environment?: core.Supplier<environments.CartesiaEnvironment | string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
         apiKey?: core.Supplier<string | undefined>;
         /** Override the Cartesia-Version header */
         cartesiaVersion?: "2024-06-10";
@@ -25,6 +26,8 @@ export declare namespace Infill {
         abortSignal?: AbortSignal;
         /** Override the Cartesia-Version header */
         cartesiaVersion?: "2024-06-10";
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string>;
     }
 }
 export declare class Infill {
@@ -33,9 +36,19 @@ export declare class Infill {
     /**
      * Generate audio that smoothly connects two existing audio segments. This is useful for inserting new speech between existing speech segments while maintaining natural transitions.
      *
+     * **The cost is 1 credit per character of the infill text plus a fixed cost of 300 credits.**
+     *
      * Only the `sonic-preview` model is supported for infill at this time.
      *
      * At least one of `left_audio` or `right_audio` must be provided.
+     *
+     * As with all generative models, there's some inherent variability, but here's some tips we recommend to get the best results from infill:
+     * - Use longer infill transcripts
+     *   - This gives the model more flexibility to adapt to the rest of the audio
+     * - Target natural pauses in the audio when deciding where to clip
+     *   - This means you don't need word-level timestamps to be as precise
+     * - Clip right up to the start and end of the audio segment you want infilled, keeping as much silence in the left/right audio segments as possible
+     *   - This helps the model generate more natural transitions
      */
     bytes(leftAudio: File | fs.ReadStream | Blob, rightAudio: File | fs.ReadStream | Blob, request: Cartesia.InfillBytesRequest, requestOptions?: Infill.RequestOptions): Promise<stream.Readable>;
     protected _getCustomAuthorizationHeaders(): Promise<{

package/dist/api/resources/infill/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) {
@@ -41,6 +51,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Infill = void 0;
 const environments = __importStar(require("../../../../environments"));
 const core = __importStar(require("../../../../core"));
+const serializers = __importStar(require("../../../../serialization/index"));
+const json_1 = require("../../../../core/json");
 const url_join_1 = __importDefault(require("url-join"));
 const errors = __importStar(require("../../../../errors/index"));
 class Infill {
@@ -50,41 +62,58 @@ class Infill {
     /**
      * Generate audio that smoothly connects two existing audio segments. This is useful for inserting new speech between existing speech segments while maintaining natural transitions.
      *
+     * **The cost is 1 credit per character of the infill text plus a fixed cost of 300 credits.**
+     *
      * Only the `sonic-preview` model is supported for infill at this time.
      *
      * At least one of `left_audio` or `right_audio` must be provided.
+     *
+     * As with all generative models, there's some inherent variability, but here's some tips we recommend to get the best results from infill:
+     * - Use longer infill transcripts
+     *   - This gives the model more flexibility to adapt to the rest of the audio
+     * - Target natural pauses in the audio when deciding where to clip
+     *   - This means you don't need word-level timestamps to be as precise
+     * - Clip right up to the start and end of the audio segment you want infilled, keeping as much silence in the left/right audio segments as possible
+     *   - This helps the model generate more natural transitions
      */
     bytes(leftAudio, rightAudio, request, requestOptions) {
-        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
             const _request = yield core.newFormData();
             yield _request.appendFile("left_audio", leftAudio);
             yield _request.appendFile("right_audio", rightAudio);
-            yield _request.append("model_id[]", request.modelId);
-            yield _request.append("language[]", request.language);
-            yield _request.append("transcript[]", request.transcript);
-            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());
+            _request.append("model_id", request.modelId);
+            _request.append("language", request.language);
+            _request.append("transcript", request.transcript);
+            _request.append("voice_id", request.voiceId);
+            _request.append("output_format[container]", serializers.OutputFormatContainer.jsonOrThrow(request.outputFormatContainer, {
+                unrecognizedObjectKeys: "strip",
+            }));
+            _request.append("output_format[sample_rate]", request.outputFormatSampleRate.toString());
             if (request.outputFormatEncoding != null) {
-                yield _request.append("output_format[encoding]", request.outputFormatEncoding);
+                _request.append("output_format[encoding]", serializers.RawEncoding.jsonOrThrow(request.outputFormatEncoding, { unrecognizedObjectKeys: "strip" }));
             }
             if (request.outputFormatBitRate != null) {
-                yield _request.append("output_format[bit_rate]", request.outputFormatBitRate.toString());
+                _request.append("output_format[bit_rate]", request.outputFormatBitRate.toString());
             }
             if (request.voiceExperimentalControlsSpeed != null) {
-                yield _request.append("voice[__experimental_controls][speed]", typeof request.voiceExperimentalControlsSpeed === "string"
-                    ? request.voiceExperimentalControlsSpeed
-                    : JSON.stringify(request.voiceExperimentalControlsSpeed));
+                _request.append("voice[__experimental_controls][speed]", (() => {
+                    const mapped = serializers.Speed.jsonOrThrow(request.voiceExperimentalControlsSpeed, {
+                        unrecognizedObjectKeys: "strip",
+                    });
+                    return typeof mapped === "string" ? mapped : (0, json_1.toJson)(mapped);
+                })());
             }
             if (request.voiceExperimentalControlsEmotion != null) {
-                yield _request.append("voice[__experimental_controls][emotion][]", request.voiceExperimentalControlsEmotion);
+                for (const _item of request.voiceExperimentalControlsEmotion) {
+                    _request.append("voice[__experimental_controls][emotion][]", serializers.Emotion.jsonOrThrow(_item, { unrecognizedObjectKeys: "strip" }));
+                }
             }
             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, "/infill/bytes"),
+                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, "/infill/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.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),
+                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,
@@ -109,7 +138,7 @@ class Infill {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /infill/bytes.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,

package/dist/api/resources/infill/client/requests/InfillBytesRequest.d.ts

@@ -11,7 +11,9 @@ import * as Cartesia from "../../../../index";
  *         voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
  *         outputFormatContainer: "mp3",
  *         outputFormatSampleRate: 44100,
- *         outputFormatBitRate: 128000
+ *         outputFormatBitRate: 128000,
+ *         voiceExperimentalControlsSpeed: "slowest",
+ *         voiceExperimentalControlsEmotion: ["surprise:high", "curiosity:high"]
  *     }
  *
  * @example
@@ -22,7 +24,9 @@ import * as Cartesia from "../../../../index";
  *         voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
  *         outputFormatContainer: "wav",
  *         outputFormatSampleRate: 44100,
- *         outputFormatEncoding: "pcm_f32le"
+ *         outputFormatEncoding: "pcm_f32le",
+ *         voiceExperimentalControlsSpeed: "slowest",
+ *         voiceExperimentalControlsEmotion: ["surprise:high", "curiosity:high"]
  *     }
  */
 export interface InfillBytesRequest {
@@ -63,5 +67,5 @@ export interface InfillBytesRequest {
      * Supported levels are: lowest, low, (omit), high, highest.
      *
      */
-    voiceExperimentalControlsEmotion?: Cartesia.Emotion;
+    voiceExperimentalControlsEmotion?: Cartesia.Emotion[];
 }

package/dist/api/resources/tts/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) {
@@ -49,8 +59,8 @@ class Tts {
         this._options = _options;
     }
     bytes(request, requestOptions) {
-        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e;
             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, "/tts/bytes"),
                 method: "POST",
@@ -79,7 +89,7 @@ class Tts {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /tts/bytes.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,
@@ -88,8 +98,8 @@ class Tts {
         });
     }
     sse(request, requestOptions) {
-        var _a, _b, _c, _d, _e;
         return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e;
             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, "/tts/sse"),
                 method: "POST",
@@ -134,7 +144,7 @@ class Tts {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /tts/sse.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,

package/dist/api/resources/tts/types/ContextId.d.ts

@@ -6,4 +6,4 @@
  *
  * Some customers use unique identifiers from their own systems (such as conversation IDs) as context IDs.
  */
-export declare type ContextId = string;
+export type ContextId = string;

package/dist/api/resources/tts/types/Emotion.d.ts

@@ -8,7 +8,7 @@
  *
  * Supported levels are: lowest, low, (omit), high, highest.
  */
-export declare type Emotion = "anger:lowest" | "anger:low" | "anger:high" | "anger:highest" | "positivity:lowest" | "positivity:low" | "positivity:high" | "positivity:highest" | "surprise:lowest" | "surprise:low" | "surprise:high" | "surprise:highest" | "sadness:lowest" | "sadness:low" | "sadness:high" | "sadness:highest" | "curiosity:lowest" | "curiosity:low" | "curiosity:high" | "curiosity:highest";
+export type Emotion = "anger:lowest" | "anger:low" | "anger:high" | "anger:highest" | "positivity:lowest" | "positivity:low" | "positivity:high" | "positivity:highest" | "surprise:lowest" | "surprise:low" | "surprise:high" | "surprise:highest" | "sadness:lowest" | "sadness:low" | "sadness:high" | "sadness:highest" | "curiosity:lowest" | "curiosity:low" | "curiosity:high" | "curiosity:highest";
 export declare const Emotion: {
     readonly AngerLowest: "anger:lowest";
     readonly AngerLow: "anger:low";

package/dist/api/resources/tts/types/FlushId.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * A unique identifier for the flush. You can use any unique identifier, like a UUID or human ID.
+ *
+ * Some customers use unique identifiers from their own systems (such as conversation IDs) as flush IDs.
+ */
+export type FlushId = number;

package/dist/api/resources/tts/types/FlushId.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/tts/types/GenerationRequest.d.ts

@@ -5,7 +5,8 @@ import * as Cartesia from "../../../index";
 export interface GenerationRequest {
     /** The ID of the model to use for the generation. See [Models](/build-with-sonic/models) for available models. */
     modelId: string;
-    transcript: string;
+    /** The transcript to generate speech for. This can be a string or an iterator over strings. */
+    transcript?: unknown;
     voice: Cartesia.TtsRequestVoiceSpecifier;
     language?: Cartesia.SupportedLanguage;
     outputFormat: Cartesia.WebSocketRawOutputFormat;
@@ -14,12 +15,14 @@ export interface GenerationRequest {
      * If the duration is not appropriate for the length of the transcript, the output audio may be truncated.
      */
     duration?: number;
-    contextId: Cartesia.ContextId;
+    contextId?: Cartesia.ContextId;
     /**
      * Whether this input may be followed by more inputs.
      * If not specified, this defaults to `false`.
      */
     continue?: boolean;
+    /** Whether to flush the context. */
+    flush?: boolean;
     /** Whether to return word-level timestamps. */
     addTimestamps?: boolean;
     /** Whether to return phoneme-level timestamps. */

package/dist/api/resources/tts/types/NaturalSpecifier.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export declare type NaturalSpecifier = "slowest" | "slow" | "normal" | "fast" | "fastest";
+export type NaturalSpecifier = "slowest" | "slow" | "normal" | "fast" | "fastest";
 export declare const NaturalSpecifier: {
     readonly Slowest: "slowest";
     readonly Slow: "slow";

package/dist/api/resources/tts/types/NumericalSpecifier.d.ts

@@ -1,4 +1,4 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export declare type NumericalSpecifier = number;
+export type NumericalSpecifier = number;

package/dist/api/resources/tts/types/OutputFormat.d.ts

@@ -2,7 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as Cartesia from "../../../index";
-export declare type OutputFormat = Cartesia.OutputFormat.Raw | Cartesia.OutputFormat.Wav | Cartesia.OutputFormat.Mp3;
+export type OutputFormat = Cartesia.OutputFormat.Raw | Cartesia.OutputFormat.Wav | Cartesia.OutputFormat.Mp3;
 export declare namespace OutputFormat {
     interface Raw extends Cartesia.RawOutputFormat {
         container: "raw";

package/dist/api/resources/tts/types/RawEncoding.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export declare type RawEncoding = "pcm_f32le" | "pcm_s16le" | "pcm_mulaw" | "pcm_alaw";
+export type RawEncoding = "pcm_f32le" | "pcm_s16le" | "pcm_mulaw" | "pcm_alaw";
 export declare const RawEncoding: {
     readonly PcmF32Le: "pcm_f32le";
     readonly PcmS16Le: "pcm_s16le";

package/dist/api/resources/tts/types/RawOutputFormat.d.ts

@@ -5,4 +5,5 @@ import * as Cartesia from "../../../index";
 export interface RawOutputFormat {
     encoding: Cartesia.RawEncoding;
     sampleRate: number;
+    bitRate?: number;
 }

package/dist/api/resources/tts/types/Speed.d.ts

@@ -7,4 +7,4 @@ import * as Cartesia from "../../../index";
  *
  * If you specify a number, 0.0 is the default speed, -1.0 is the slowest speed, and 1.0 is the fastest speed.
  */
-export declare type Speed = Cartesia.NumericalSpecifier | Cartesia.NaturalSpecifier;
+export type Speed = Cartesia.NumericalSpecifier | Cartesia.NaturalSpecifier;

package/dist/api/resources/tts/types/SupportedLanguage.d.ts

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

package/dist/api/resources/tts/types/TtsRequestVoiceSpecifier.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 TtsRequestVoiceSpecifier = Cartesia.TtsRequestIdSpecifier | Cartesia.TtsRequestEmbeddingSpecifier;
+export type TtsRequestVoiceSpecifier = Cartesia.TtsRequestIdSpecifier | Cartesia.TtsRequestEmbeddingSpecifier;