@cartesia/cartesia-js 2.1.3 → 2.1.5

package/dist/api/resources/index.js

@@ -15,18 +15,28 @@ 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);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.voices = exports.voiceChanger = exports.tts = exports.embedding = exports.datasets = exports.apiStatus = void 0;
+exports.infill = exports.voices = exports.voiceChanger = exports.tts = exports.embedding = exports.datasets = exports.apiStatus = void 0;
 exports.apiStatus = __importStar(require("./apiStatus"));
 __exportStar(require("./apiStatus/types"), exports);
 exports.datasets = __importStar(require("./datasets"));
@@ -39,6 +49,8 @@ exports.voiceChanger = __importStar(require("./voiceChanger"));
 __exportStar(require("./voiceChanger/types"), exports);
 exports.voices = __importStar(require("./voices"));
 __exportStar(require("./voices/types"), exports);
+exports.infill = __importStar(require("./infill"));
 __exportStar(require("./datasets/client/requests"), exports);
+__exportStar(require("./infill/client/requests"), exports);
 __exportStar(require("./voiceChanger/client/requests"), exports);
 __exportStar(require("./voices/client/requests"), exports);

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

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

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

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.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 {
+    constructor(_options = {}) {
+        this._options = _options;
+    }
+    /**
+     * 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.
+     */
+    bytes(leftAudio, rightAudio, 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("left_audio", leftAudio);
+            yield _request.appendFile("right_audio", rightAudio);
+            _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) {
+                _request.append("output_format[encoding]", serializers.RawEncoding.jsonOrThrow(request.outputFormatEncoding, { unrecognizedObjectKeys: "strip" }));
+            }
+            if (request.outputFormatBitRate != null) {
+                _request.append("output_format[bit_rate]", request.outputFormatBitRate.toString());
+            }
+            if (request.voiceExperimentalControlsSpeed != null) {
+                _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) {
+                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)((_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(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.5", "User-Agent": "@cartesia/cartesia-js/2.1.5", "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,
+                responseType: "streaming",
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return _response.body;
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.CartesiaError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                });
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.CartesiaError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                    });
+                case "timeout":
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /infill/bytes.");
+                case "unknown":
+                    throw new errors.CartesiaError({
+                        message: _response.error.errorMessage,
+                    });
+            }
+        });
+    }
+    _getCustomAuthorizationHeaders() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const apiKeyValue = yield core.Supplier.get(this._options.apiKey);
+            return { "X-API-Key": apiKeyValue };
+        });
+    }
+}
+exports.Infill = Infill;

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

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

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../../index";
+/**
+ * @example
+ *     {
+ *         modelId: "sonic-preview",
+ *         language: "en",
+ *         transcript: "middle segment",
+ *         voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
+ *         outputFormatContainer: "mp3",
+ *         outputFormatSampleRate: 44100,
+ *         outputFormatBitRate: 128000,
+ *         voiceExperimentalControlsSpeed: "slowest",
+ *         voiceExperimentalControlsEmotion: ["surprise:high", "curiosity:high"]
+ *     }
+ *
+ * @example
+ *     {
+ *         modelId: "sonic-preview",
+ *         language: "en",
+ *         transcript: "middle segment",
+ *         voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
+ *         outputFormatContainer: "wav",
+ *         outputFormatSampleRate: 44100,
+ *         outputFormatEncoding: "pcm_f32le",
+ *         voiceExperimentalControlsSpeed: "slowest",
+ *         voiceExperimentalControlsEmotion: ["surprise:high", "curiosity:high"]
+ *     }
+ */
+export interface InfillBytesRequest {
+    /** The ID of the model to use for generating audio */
+    modelId: string;
+    /** The language of the transcript */
+    language: string;
+    /** The infill text to generate */
+    transcript: string;
+    /** The ID of the voice to use for generating audio */
+    voiceId: string;
+    /** The format of the output audio */
+    outputFormatContainer: Cartesia.OutputFormatContainer;
+    /** The sample rate of the output audio */
+    outputFormatSampleRate: number;
+    /**
+     * Required for `raw` and `wav` containers.
+     *
+     */
+    outputFormatEncoding?: Cartesia.RawEncoding;
+    /**
+     * Required for `mp3` containers.
+     *
+     */
+    outputFormatBitRate?: number;
+    /**
+     * Either a number between -1.0 and 1.0 or a natural language description of speed.
+     *
+     * If you specify a number, 0.0 is the default speed, -1.0 is the slowest speed, and 1.0 is the fastest speed.
+     *
+     */
+    voiceExperimentalControlsSpeed?: Cartesia.Speed;
+    /**
+     * An array of emotion:level tags.
+     *
+     * Supported emotions are: anger, positivity, surprise, sadness, and curiosity.
+     *
+     * Supported levels are: lowest, low, (omit), high, highest.
+     *
+     */
+    voiceExperimentalControlsEmotion?: Cartesia.Emotion[];
+}

package/dist/api/resources/infill/client/requests/InfillBytesRequest.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/infill/client/requests/index.d.ts

@@ -0,0 +1 @@
+export { type InfillBytesRequest } from "./InfillBytesRequest";

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

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

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

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

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

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

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:high" | "surprise:highest" | "sadness:lowest" | "sadness:low" | "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";
@@ -19,10 +19,14 @@ export declare const Emotion: {
     readonly PositivityHigh: "positivity:high";
     readonly PositivityHighest: "positivity:highest";
     readonly SurpriseLowest: "surprise:lowest";
+    readonly SurpriseLow: "surprise:low";
     readonly SurpriseHigh: "surprise:high";
     readonly SurpriseHighest: "surprise:highest";
     readonly SadnessLowest: "sadness:lowest";
     readonly SadnessLow: "sadness:low";
+    readonly SadnessHigh: "sadness:high";
+    readonly SadnessHighest: "sadness:highest";
+    readonly CuriosityLowest: "curiosity:lowest";
     readonly CuriosityLow: "curiosity:low";
     readonly CuriosityHigh: "curiosity:high";
     readonly CuriosityHighest: "curiosity:highest";

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

@@ -14,10 +14,14 @@ exports.Emotion = {
     PositivityHigh: "positivity:high",
     PositivityHighest: "positivity:highest",
     SurpriseLowest: "surprise:lowest",
+    SurpriseLow: "surprise:low",
     SurpriseHigh: "surprise:high",
     SurpriseHighest: "surprise:highest",
     SadnessLowest: "sadness:lowest",
     SadnessLow: "sadness:low",
+    SadnessHigh: "sadness:high",
+    SadnessHighest: "sadness:highest",
+    CuriosityLowest: "curiosity:lowest",
     CuriosityLow: "curiosity:low",
     CuriosityHigh: "curiosity:high",
     CuriosityHighest: "curiosity:highest",

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,16 @@ 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. */
+    addPhonemeTimestamps?: boolean;
 }

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/PhonemeTimestamps.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface PhonemeTimestamps {
+    phonemes: string[];
+    start: number[];
+    end: number[];
+}

package/dist/api/resources/tts/types/PhonemeTimestamps.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/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;

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Cartesia from "../../../index";
+export interface WebSocketFlushDoneResponse extends Cartesia.WebSocketBaseResponse {
+    flushId: Cartesia.FlushId;
+    flushDone: boolean;
+}

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

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