@breeze.blue/sdk 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.16.0
+
+- Clone previews use an automatically generated script in the reference audio language. Custom text, instructions, and language hints are not accepted.
+- Breaking: remove `text`, `instructions`, `languageCode`, and `previewLanguageCode` from `voices.createClonePreview(...)` calls. Use Text to Speech with a saved voice for custom scripts and performance instructions.
+
 ## 0.15.0
 
 - Added `previewLanguageCode` to Voice Clone previews independently of the reference audio language hint.

package/README.md

@@ -454,7 +454,6 @@ const clonePreview = await client.voices.createClonePreview({
     filename: "sample.wav",
     contentType: "audio/wav",
   },
-  text: "This is a short preview script.",
 });
 let generatedVoiceId = clonePreview.generatedVoiceId;
 
@@ -574,7 +573,7 @@ try {
 
 Each API error exposes `status`, `code`, `detail`, `meta`, and `headers`.
 
-Clone previews identify the reference audio language and preview text language independently. Use `previewLanguageCode` for an explicit target hint when the text is ambiguous. Reference language hints do not override audio recognition; save cross-language previews with the original reference language.
+Clone previews automatically generate a short script in the detected reference audio language. They accept a reference sample, name, and optional description. Save the preview as a voice, then use Text to Speech for custom scripts, instructions, or target languages.
 
 ### HTTP TTS speed
 

package/dist/client.js

@@ -1727,13 +1727,14 @@ function clonePreviewForm(request) {
     if (request.removeBackgroundNoise) {
         throw new BreezeBlueConfigurationError("removeBackgroundNoise is not supported by the Breeze Developer API.");
     }
+    for (const field of ["text", "instructions", "languageCode", "previewLanguageCode"]) {
+        if (field in request) {
+            throw new BreezeBlueConfigurationError(`Clone previews do not accept ${field}; the script and language are generated automatically.`);
+        }
+    }
     const form = new FormData();
     form.set("name", request.name);
     appendOptional(form, "description", request.description);
-    appendOptional(form, "language_code", request.languageCode);
-    appendOptional(form, "preview_language_code", request.previewLanguageCode);
-    appendOptional(form, "text", request.text);
-    appendOptional(form, "instructions", request.instructions);
     for (const file of normalizeFiles(request.file, request.files, { required: true })) {
         appendFile(form, "files", file);
     }

package/dist/types.d.ts

@@ -392,12 +392,6 @@ export interface VoiceClonePreviewRequest {
     files?: Array<UploadData | UploadFile>;
     description?: string;
     removeBackgroundNoise?: boolean;
-    /** Reference language hint; audio recognition remains authoritative. */
-    languageCode?: VoiceLanguageCode;
-    /** Target hint used when preview text language is uncertain. */
-    previewLanguageCode?: VoiceLanguageCode;
-    text?: string;
-    instructions?: string;
 }
 export interface VoiceClonePreview {
     generatedVoiceId: string;

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "0.15.0";
+export declare const SDK_VERSION = "0.16.0";
 export declare const SDK_NAME = "@breeze.blue/sdk";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const SDK_VERSION = "0.15.0";
+export const SDK_VERSION = "0.16.0";
 export const SDK_NAME = "@breeze.blue/sdk";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breeze.blue/sdk",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "ESM-first TypeScript SDK for the Breeze Blue Developer API.",
   "license": "MIT",
   "author": "Breeze Blue <support@breezeblue.ai>",