@cartesia/cartesia-js 2.1.4 → 2.1.6

package/Client.d.ts

@@ -12,6 +12,8 @@ import { Voices } from "./api/resources/voices/client/Client";
 export declare namespace CartesiaClient {
     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";
@@ -26,21 +28,23 @@ export declare namespace CartesiaClient {
         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 CartesiaClient {
     protected readonly _options: CartesiaClient.Options;
-    constructor(_options?: CartesiaClient.Options);
     protected _apiStatus: ApiStatus | undefined;
-    get apiStatus(): ApiStatus;
     protected _datasets: Datasets | undefined;
-    get datasets(): Datasets;
     protected _infill: Infill | undefined;
-    get infill(): Infill;
     protected _tts: Tts | undefined;
-    get tts(): Tts;
     protected _voiceChanger: VoiceChanger | undefined;
-    get voiceChanger(): VoiceChanger;
     protected _voices: Voices | undefined;
+    constructor(_options?: CartesiaClient.Options);
+    get apiStatus(): ApiStatus;
+    get datasets(): Datasets;
+    get infill(): Infill;
+    get tts(): Tts;
+    get voiceChanger(): VoiceChanger;
     get voices(): Voices;
 }

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

@@ -7,6 +7,8 @@ import * as Cartesia from "../../../index";
 export declare namespace ApiStatus {
     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";
@@ -21,6 +23,8 @@ export declare namespace ApiStatus {
         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 ApiStatus {

package/api/resources/apiStatus/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) {
@@ -51,12 +61,12 @@ class ApiStatus {
      *     await client.apiStatus.get()
      */
     get(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: (_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.CartesiaEnvironment.Production,
+                url: (_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,
                 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,
@@ -85,7 +95,7 @@ class ApiStatus {
                         body: _response.error.rawBody,
                     });
                 case "timeout":
-                    throw new errors.CartesiaTimeoutError();
+                    throw new errors.CartesiaTimeoutError("Timeout exceeded when calling GET /.");
                 case "unknown":
                     throw new errors.CartesiaError({
                         message: _response.error.errorMessage,

package/api/resources/datasets/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 Cartesia from "../../../index";
@@ -10,6 +9,8 @@ import { Blob } from "buffer";
 export declare namespace Datasets {
     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";
@@ -24,6 +25,8 @@ export declare namespace Datasets {
         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 Datasets {
@@ -42,7 +45,7 @@ export declare class Datasets {
      *
      * @example
      *     await client.datasets.create({
-     *         name: "string"
+     *         name: "name"
      *     })
      */
     create(request: Cartesia.CreateDatasetRequest, requestOptions?: Datasets.RequestOptions): Promise<Cartesia.Dataset>;
@@ -51,7 +54,7 @@ export declare class Datasets {
      * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
-     *     await client.datasets.listFiles("string")
+     *     await client.datasets.listFiles("id")
      */
     listFiles(id: string, requestOptions?: Datasets.RequestOptions): Promise<Cartesia.PaginatedDatasetFiles>;
     /**
@@ -59,9 +62,6 @@ export declare 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: File | fs.ReadStream | Blob, id: string, request: Cartesia.UploadDatasetFileRequest, requestOptions?: Datasets.RequestOptions): Promise<void>;
     protected _getCustomAuthorizationHeaders(): Promise<{

package/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/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/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/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/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/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/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/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[];
 }