@cartesia/cartesia-js 2.1.5 → 2.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/api/resources/apiStatus/client/Client.js +1 -1
  2. package/api/resources/datasets/client/Client.d.ts +2 -5
  3. package/api/resources/datasets/client/Client.js +6 -9
  4. package/api/resources/datasets/client/requests/UploadDatasetFileRequest.d.ts +0 -4
  5. package/api/resources/infill/client/Client.d.ts +9 -1
  6. package/api/resources/infill/client/Client.js +10 -2
  7. package/api/resources/voices/client/Client.d.ts +51 -41
  8. package/api/resources/voices/client/Client.js +83 -73
  9. package/api/resources/voices/types/BaseVoiceId.d.ts +1 -1
  10. package/api/resources/voices/types/CreateVoiceRequest.d.ts +1 -0
  11. package/api/resources/voices/types/LocalizeVoiceRequest.d.ts +6 -1
  12. package/dist/api/resources/apiStatus/client/Client.js +1 -1
  13. package/dist/api/resources/datasets/client/Client.d.ts +2 -5
  14. package/dist/api/resources/datasets/client/Client.js +6 -9
  15. package/dist/api/resources/datasets/client/requests/UploadDatasetFileRequest.d.ts +0 -4
  16. package/dist/api/resources/infill/client/Client.d.ts +9 -1
  17. package/dist/api/resources/infill/client/Client.js +10 -2
  18. package/dist/api/resources/voices/client/Client.d.ts +51 -41
  19. package/dist/api/resources/voices/client/Client.js +83 -73
  20. package/dist/api/resources/voices/types/BaseVoiceId.d.ts +1 -1
  21. package/dist/api/resources/voices/types/CreateVoiceRequest.d.ts +1 -0
  22. package/dist/api/resources/voices/types/LocalizeVoiceRequest.d.ts +6 -1
  23. package/dist/serialization/resources/voices/types/CreateVoiceRequest.d.ts +2 -0
  24. package/dist/serialization/resources/voices/types/CreateVoiceRequest.js +2 -0
  25. package/dist/serialization/resources/voices/types/LocalizeVoiceRequest.d.ts +3 -2
  26. package/dist/serialization/resources/voices/types/LocalizeVoiceRequest.js +3 -2
  27. package/dist/version.d.ts +1 -1
  28. package/dist/version.js +1 -1
  29. package/package.json +1 -1
  30. package/reference.md +91 -124
  31. package/serialization/resources/voices/types/CreateVoiceRequest.d.ts +2 -0
  32. package/serialization/resources/voices/types/CreateVoiceRequest.js +2 -0
  33. package/serialization/resources/voices/types/LocalizeVoiceRequest.d.ts +3 -2
  34. package/serialization/resources/voices/types/LocalizeVoiceRequest.js +3 -2
  35. package/version.d.ts +1 -1
  36. package/version.js +1 -1
package/api/resources/voices/client/Client.js CHANGED
@@ -70,7 +70,7 @@ class Voices {
70
70
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
71
71
  url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/"),
72
72
  method: "GET",
73
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
73
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
74
74
  contentType: "application/json",
75
75
  requestType: "json",
76
76
  timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -108,33 +108,64 @@ class Voices {
108
108
  });
109
109
  }
110
110
  /**
111
- * @param {Cartesia.CreateVoiceRequest} request
111
+ * Clone a voice from an audio clip. This endpoint has two modes, stability and similarity.
112
+ *
113
+ * Similarity mode clones are more similar to the source clip, but may reproduce background noise. For these, use an audio clip about 5 seconds long.
114
+ *
115
+ * Stability mode clones are more stable, but may not sound as similar to the source clip. For these, use an audio clip 10-20 seconds long.
116
+ *
117
+ * @param {File | fs.ReadStream | Blob} clip
118
+ * @param {Cartesia.CloneVoiceRequest} request
112
119
  * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
113
120
  *
114
121
  * @example
115
- * await client.voices.create({
116
- * name: "string",
117
- * description: "string",
118
- * embedding: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
119
- * language: "en"
122
+ * await client.voices.clone(fs.createReadStream("/path/to/your/file"), {
123
+ * name: "A high-stability cloned voice",
124
+ * description: "Copied from Cartesia docs",
125
+ * mode: "stability",
126
+ * language: "en",
127
+ * enhance: true
128
+ * })
129
+ *
130
+ * @example
131
+ * await client.voices.clone(fs.createReadStream("/path/to/your/file"), {
132
+ * name: "A high-similarity cloned voice",
133
+ * description: "Copied from Cartesia docs",
134
+ * mode: "similarity",
135
+ * language: "en",
136
+ * transcript: "A transcript of the words spoken in the audio clip.",
137
+ * enhance: false
120
138
  * })
121
139
  */
122
- create(request, requestOptions) {
140
+ clone(clip, request, requestOptions) {
123
141
  return __awaiter(this, void 0, void 0, function* () {
124
142
  var _a, _b, _c, _d, _e, _f;
143
+ const _request = yield core.newFormData();
144
+ yield _request.appendFile("clip", clip);
145
+ _request.append("name", request.name);
146
+ if (request.description != null) {
147
+ _request.append("description", request.description);
148
+ }
149
+ _request.append("language", serializers.SupportedLanguage.jsonOrThrow(request.language, { unrecognizedObjectKeys: "strip" }));
150
+ _request.append("mode", serializers.CloneMode.jsonOrThrow(request.mode, { unrecognizedObjectKeys: "strip" }));
151
+ _request.append("enhance", request.enhance.toString());
152
+ if (request.transcript != null) {
153
+ _request.append("transcript", request.transcript);
154
+ }
155
+ const _maybeEncodedRequest = yield _request.getRequest();
125
156
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
126
- url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/"),
157
+ url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/clone"),
127
158
  method: "POST",
128
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
129
- contentType: "application/json",
130
- requestType: "json",
131
- body: serializers.CreateVoiceRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
159
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
160
+ requestType: "file",
161
+ duplex: _maybeEncodedRequest.duplex,
162
+ body: _maybeEncodedRequest.body,
132
163
  timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
133
164
  maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
134
165
  abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
135
166
  });
136
167
  if (_response.ok) {
137
- return serializers.Voice.parseOrThrow(_response.body, {
168
+ return serializers.VoiceMetadata.parseOrThrow(_response.body, {
138
169
  unrecognizedObjectKeys: "passthrough",
139
170
  allowUnrecognizedUnionMembers: true,
140
171
  allowUnrecognizedEnumValues: true,
@@ -155,7 +186,7 @@ class Voices {
155
186
  body: _response.error.rawBody,
156
187
  });
157
188
  case "timeout":
158
- throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /voices/.");
189
+ throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /voices/clone.");
159
190
  case "unknown":
160
191
  throw new errors.CartesiaError({
161
192
  message: _response.error.errorMessage,
@@ -168,7 +199,7 @@ class Voices {
168
199
  * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
169
200
  *
170
201
  * @example
171
- * await client.voices.delete("string")
202
+ * await client.voices.delete("id")
172
203
  */
173
204
  delete(id, requestOptions) {
174
205
  return __awaiter(this, void 0, void 0, function* () {
@@ -176,7 +207,7 @@ class Voices {
176
207
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
177
208
  url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, `/voices/${encodeURIComponent(serializers.VoiceId.jsonOrThrow(id))}`),
178
209
  method: "DELETE",
179
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
210
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
180
211
  contentType: "application/json",
181
212
  requestType: "json",
182
213
  timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -213,9 +244,9 @@ class Voices {
213
244
  * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
214
245
  *
215
246
  * @example
216
- * await client.voices.update("string", {
217
- * name: "string",
218
- * description: "string"
247
+ * await client.voices.update("id", {
248
+ * name: "name",
249
+ * description: "description"
219
250
  * })
220
251
  */
221
252
  update(id, request, requestOptions) {
@@ -224,7 +255,7 @@ class Voices {
224
255
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
225
256
  url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, `/voices/${encodeURIComponent(serializers.VoiceId.jsonOrThrow(id))}`),
226
257
  method: "PATCH",
227
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
258
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
228
259
  contentType: "application/json",
229
260
  requestType: "json",
230
261
  body: serializers.UpdateVoiceRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -267,7 +298,7 @@ class Voices {
267
298
  * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
268
299
  *
269
300
  * @example
270
- * await client.voices.get("string")
301
+ * await client.voices.get("id")
271
302
  */
272
303
  get(id, requestOptions) {
273
304
  return __awaiter(this, void 0, void 0, function* () {
@@ -275,7 +306,7 @@ class Voices {
275
306
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
276
307
  url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, `/voices/${encodeURIComponent(serializers.VoiceId.jsonOrThrow(id))}`),
277
308
  method: "GET",
278
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
309
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
279
310
  contentType: "application/json",
280
311
  requestType: "json",
281
312
  timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -313,15 +344,19 @@ class Voices {
313
344
  });
314
345
  }
315
346
  /**
347
+ * Create a new voice from an existing voice localized to a new language and dialect.
348
+ *
316
349
  * @param {Cartesia.LocalizeVoiceRequest} request
317
350
  * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
318
351
  *
319
352
  * @example
320
353
  * await client.voices.localize({
321
- * embedding: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
322
- * language: "en",
323
- * originalSpeakerGender: "male",
324
- * dialect: "au"
354
+ * voiceId: "694f9389-aac1-45b6-b726-9d9369183238",
355
+ * name: "Sarah Peninsular Spanish",
356
+ * description: "Sarah Voice in Peninsular Spanish",
357
+ * language: "es",
358
+ * originalSpeakerGender: "female",
359
+ * dialect: "pe"
325
360
  * })
326
361
  */
327
362
  localize(request, requestOptions) {
@@ -330,7 +365,7 @@ class Voices {
330
365
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
331
366
  url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/localize"),
332
367
  method: "POST",
333
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
368
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
334
369
  contentType: "application/json",
335
370
  requestType: "json",
336
371
  body: serializers.LocalizeVoiceRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -339,7 +374,7 @@ class Voices {
339
374
  abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
340
375
  });
341
376
  if (_response.ok) {
342
- return serializers.EmbeddingResponse.parseOrThrow(_response.body, {
377
+ return serializers.VoiceMetadata.parseOrThrow(_response.body, {
343
378
  unrecognizedObjectKeys: "passthrough",
344
379
  allowUnrecognizedUnionMembers: true,
345
380
  allowUnrecognizedEnumValues: true,
@@ -375,7 +410,10 @@ class Voices {
375
410
  * @example
376
411
  * await client.voices.mix({
377
412
  * voices: [{
378
- * id: "string",
413
+ * id: "id",
414
+ * weight: 1.1
415
+ * }, {
416
+ * id: "id",
379
417
  * weight: 1.1
380
418
  * }]
381
419
  * })
@@ -386,7 +424,7 @@ class Voices {
386
424
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
387
425
  url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/mix"),
388
426
  method: "POST",
389
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
427
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
390
428
  contentType: "application/json",
391
429
  requestType: "json",
392
430
  body: serializers.MixVoicesRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -425,58 +463,30 @@ class Voices {
425
463
  });
426
464
  }
427
465
  /**
428
- * Clone a voice from an audio clip. This endpoint has two modes, stability and similarity.
429
- *
430
- * Similarity mode clones are more similar to the source clip, but may reproduce background noise. For these, use an audio clip about 5 seconds long.
466
+ * Create voice from raw features. If you'd like to clone a voice from an audio file, please use Clone Voice instead.
431
467
  *
432
- * Stability mode clones are more stable, but may not sound as similar to the source clip. For these, use an audio clip 10-20 seconds long.
433
- *
434
- * @param {File | fs.ReadStream | Blob} clip
435
- * @param {Cartesia.CloneVoiceRequest} request
468
+ * @param {Cartesia.CreateVoiceRequest} request
436
469
  * @param {Voices.RequestOptions} requestOptions - Request-specific configuration.
437
470
  *
438
471
  * @example
439
- * await client.voices.clone(fs.createReadStream("/path/to/your/file"), {
440
- * name: "A high-stability cloned voice",
441
- * description: "Copied from Cartesia docs",
442
- * mode: "stability",
472
+ * await client.voices.create({
473
+ * name: "My Custom Voice",
474
+ * description: "A custom voice created through the API",
475
+ * embedding: [],
443
476
  * language: "en",
444
- * enhance: true
445
- * })
446
- *
447
- * @example
448
- * await client.voices.clone(fs.createReadStream("/path/to/your/file"), {
449
- * name: "A high-similarity cloned voice",
450
- * description: "Copied from Cartesia docs",
451
- * mode: "similarity",
452
- * language: "en",
453
- * transcript: "A transcript of the words spoken in the audio clip.",
454
- * enhance: false
477
+ * baseVoiceId: "123e4567-e89b-12d3-a456-426614174000"
455
478
  * })
456
479
  */
457
- clone(clip, request, requestOptions) {
480
+ create(request, requestOptions) {
458
481
  return __awaiter(this, void 0, void 0, function* () {
459
482
  var _a, _b, _c, _d, _e, _f;
460
- const _request = yield core.newFormData();
461
- yield _request.appendFile("clip", clip);
462
- _request.append("name", request.name);
463
- if (request.description != null) {
464
- _request.append("description", request.description);
465
- }
466
- _request.append("language", serializers.SupportedLanguage.jsonOrThrow(request.language, { unrecognizedObjectKeys: "strip" }));
467
- _request.append("mode", serializers.CloneMode.jsonOrThrow(request.mode, { unrecognizedObjectKeys: "strip" }));
468
- _request.append("enhance", request.enhance.toString());
469
- if (request.transcript != null) {
470
- _request.append("transcript", request.transcript);
471
- }
472
- const _maybeEncodedRequest = yield _request.getRequest();
473
483
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
474
- url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/clone"),
484
+ url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CartesiaEnvironment.Production, "/voices/"),
475
485
  method: "POST",
476
- 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),
477
- requestType: "file",
478
- duplex: _maybeEncodedRequest.duplex,
479
- body: _maybeEncodedRequest.body,
486
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
487
+ contentType: "application/json",
488
+ requestType: "json",
489
+ body: serializers.CreateVoiceRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
480
490
  timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
481
491
  maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
482
492
  abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -503,7 +513,7 @@ class Voices {
503
513
  body: _response.error.rawBody,
504
514
  });
505
515
  case "timeout":
506
- throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /voices/clone.");
516
+ throw new errors.CartesiaTimeoutError("Timeout exceeded when calling POST /voices/.");
507
517
  case "unknown":
508
518
  throw new errors.CartesiaError({
509
519
  message: _response.error.errorMessage,
package/api/resources/voices/types/BaseVoiceId.d.ts CHANGED
@@ -3,6 +3,6 @@
3
3
  */
4
4
  import * as Cartesia from "../../../index";
5
5
  /**
6
- * The ID of the base voice associated with the voice, used for features like voice mixing.
6
+ * Pull in features from a base voice, used for features like voice mixing.
7
7
  */
8
8
  export type BaseVoiceId = Cartesia.VoiceId;
package/api/resources/voices/types/CreateVoiceRequest.d.ts CHANGED
@@ -9,4 +9,5 @@ export interface CreateVoiceRequest {
9
9
  description: string;
10
10
  embedding: Cartesia.Embedding;
11
11
  language?: Cartesia.SupportedLanguage;
12
+ baseVoiceId?: Cartesia.BaseVoiceId;
12
13
  }
package/api/resources/voices/types/LocalizeVoiceRequest.d.ts CHANGED
@@ -3,7 +3,12 @@
3
3
  */
4
4
  import * as Cartesia from "../../../index";
5
5
  export interface LocalizeVoiceRequest {
6
- embedding: Cartesia.Embedding;
6
+ /** The ID of the voice to localize. */
7
+ voiceId: string;
8
+ /** The name of the new localized voice. */
9
+ name: string;
10
+ /** The description of the new localized voice. */
11
+ description: string;
7
12
  language: Cartesia.LocalizeTargetLanguage;
8
13
  originalSpeakerGender: Cartesia.Gender;
9
14
  dialect?: Cartesia.LocalizeDialect;
package/dist/api/resources/apiStatus/client/Client.js CHANGED
@@ -66,7 +66,7 @@ class ApiStatus {
66
66
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
67
67
  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,
68
68
  method: "GET",
69
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
69
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
70
70
  contentType: "application/json",
71
71
  requestType: "json",
72
72
  timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
package/dist/api/resources/datasets/client/Client.d.ts CHANGED
@@ -45,7 +45,7 @@ export declare class Datasets {
45
45
  *
46
46
  * @example
47
47
  * await client.datasets.create({
48
- * name: "string"
48
+ * name: "name"
49
49
  * })
50
50
  */
51
51
  create(request: Cartesia.CreateDatasetRequest, requestOptions?: Datasets.RequestOptions): Promise<Cartesia.Dataset>;
@@ -54,7 +54,7 @@ export declare class Datasets {
54
54
  * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
55
55
  *
56
56
  * @example
57
- * await client.datasets.listFiles("string")
57
+ * await client.datasets.listFiles("id")
58
58
  */
59
59
  listFiles(id: string, requestOptions?: Datasets.RequestOptions): Promise<Cartesia.PaginatedDatasetFiles>;
60
60
  /**
@@ -62,9 +62,6 @@ export declare class Datasets {
62
62
  * @param {string} id
63
63
  * @param {Cartesia.UploadDatasetFileRequest} request
64
64
  * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
65
- *
66
- * @example
67
- * await client.datasets.uploadFile(fs.createReadStream("/path/to/your/file"), "string", {})
68
65
  */
69
66
  uploadFile(file: File | fs.ReadStream | Blob, id: string, request: Cartesia.UploadDatasetFileRequest, requestOptions?: Datasets.RequestOptions): Promise<void>;
70
67
  protected _getCustomAuthorizationHeaders(): Promise<{
package/dist/api/resources/datasets/client/Client.js CHANGED
@@ -70,7 +70,7 @@ class Datasets {
70
70
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
71
71
  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/"),
72
72
  method: "GET",
73
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
73
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
74
74
  contentType: "application/json",
75
75
  requestType: "json",
76
76
  timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -113,7 +113,7 @@ class Datasets {
113
113
  *
114
114
  * @example
115
115
  * await client.datasets.create({
116
- * name: "string"
116
+ * name: "name"
117
117
  * })
118
118
  */
119
119
  create(request, requestOptions) {
@@ -122,7 +122,7 @@ class Datasets {
122
122
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
123
123
  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/"),
124
124
  method: "POST",
125
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
125
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
126
126
  contentType: "application/json",
127
127
  requestType: "json",
128
128
  body: serializers.CreateDatasetRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -165,7 +165,7 @@ class Datasets {
165
165
  * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
166
166
  *
167
167
  * @example
168
- * await client.datasets.listFiles("string")
168
+ * await client.datasets.listFiles("id")
169
169
  */
170
170
  listFiles(id, requestOptions) {
171
171
  return __awaiter(this, void 0, void 0, function* () {
@@ -173,7 +173,7 @@ class Datasets {
173
173
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
174
174
  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`),
175
175
  method: "GET",
176
- 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.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())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
176
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
177
177
  contentType: "application/json",
178
178
  requestType: "json",
179
179
  timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -215,9 +215,6 @@ class Datasets {
215
215
  * @param {string} id
216
216
  * @param {Cartesia.UploadDatasetFileRequest} request
217
217
  * @param {Datasets.RequestOptions} requestOptions - Request-specific configuration.
218
- *
219
- * @example
220
- * await client.datasets.uploadFile(fs.createReadStream("/path/to/your/file"), "string", {})
221
218
  */
222
219
  uploadFile(file, id, request, requestOptions) {
223
220
  return __awaiter(this, void 0, void 0, function* () {
@@ -229,7 +226,7 @@ class Datasets {
229
226
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
230
227
  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`),
231
228
  method: "POST",
232
- 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),
229
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
233
230
  requestType: "file",
234
231
  duplex: _maybeEncodedRequest.duplex,
235
232
  body: _maybeEncodedRequest.body,
package/dist/api/resources/datasets/client/requests/UploadDatasetFileRequest.d.ts CHANGED
@@ -2,10 +2,6 @@
2
2
  * This file was auto-generated by Fern from our API Definition.
3
3
  */
4
4
  import * as Cartesia from "../../../../index";
5
- /**
6
- * @example
7
- * {}
8
- */
9
5
  export interface UploadDatasetFileRequest {
10
6
  purpose: Cartesia.FilePurpose;
11
7
  }
package/dist/api/resources/infill/client/Client.d.ts CHANGED
@@ -36,11 +36,19 @@ export declare class Infill {
36
36
  /**
37
37
  * Generate audio that smoothly connects two existing audio segments. This is useful for inserting new speech between existing speech segments while maintaining natural transitions.
38
38
  *
39
- * The cost is 1 credit per character of the infill text plus a fixed cost of 300 credits.
39
+ * **The cost is 1 credit per character of the infill text plus a fixed cost of 300 credits.**
40
40
  *
41
41
  * Only the `sonic-preview` model is supported for infill at this time.
42
42
  *
43
43
  * At least one of `left_audio` or `right_audio` must be provided.
44
+ *
45
+ * As with all generative models, there's some inherent variability, but here's some tips we recommend to get the best results from infill:
46
+ * - Use longer infill transcripts
47
+ * - This gives the model more flexibility to adapt to the rest of the audio
48
+ * - Target natural pauses in the audio when deciding where to clip
49
+ * - This means you don't need word-level timestamps to be as precise
50
+ * - 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
51
+ * - This helps the model generate more natural transitions
44
52
  */
45
53
  bytes(leftAudio: File | fs.ReadStream | Blob, rightAudio: File | fs.ReadStream | Blob, request: Cartesia.InfillBytesRequest, requestOptions?: Infill.RequestOptions): Promise<stream.Readable>;
46
54
  protected _getCustomAuthorizationHeaders(): Promise<{
package/dist/api/resources/infill/client/Client.js CHANGED
@@ -62,11 +62,19 @@ class Infill {
62
62
  /**
63
63
  * Generate audio that smoothly connects two existing audio segments. This is useful for inserting new speech between existing speech segments while maintaining natural transitions.
64
64
  *
65
- * The cost is 1 credit per character of the infill text plus a fixed cost of 300 credits.
65
+ * **The cost is 1 credit per character of the infill text plus a fixed cost of 300 credits.**
66
66
  *
67
67
  * Only the `sonic-preview` model is supported for infill at this time.
68
68
  *
69
69
  * At least one of `left_audio` or `right_audio` must be provided.
70
+ *
71
+ * As with all generative models, there's some inherent variability, but here's some tips we recommend to get the best results from infill:
72
+ * - Use longer infill transcripts
73
+ * - This gives the model more flexibility to adapt to the rest of the audio
74
+ * - Target natural pauses in the audio when deciding where to clip
75
+ * - This means you don't need word-level timestamps to be as precise
76
+ * - 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
77
+ * - This helps the model generate more natural transitions
70
78
  */
71
79
  bytes(leftAudio, rightAudio, request, requestOptions) {
72
80
  return __awaiter(this, void 0, void 0, function* () {
@@ -105,7 +113,7 @@ class Infill {
105
113
  const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
106
114
  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"),
107
115
  method: "POST",
108
- 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),
116
+ 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.7", "User-Agent": "@cartesia/cartesia-js/2.1.7", "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),
109
117
  requestType: "file",
110
118
  duplex: _maybeEncodedRequest.duplex,
111
119
  body: _maybeEncodedRequest.body,