@breeze.blue/sdk 0.14.0 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # 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.
+- Expanded voice language metadata for the Multilingual-51 model.
+
 ## 0.14.0
 
 - Added `account.currentApiKey()` for checking the authenticating key's status

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;
 
@@ -573,3 +572,9 @@ try {
 ```
 
 Each API error exposes `status`, `code`, `detail`, `meta`, and `headers`.
+
+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
+
+Pass `voiceSettings: { speed: 1.25 }` to control speech speed without changing pitch, from 0.5 to 2.0. Omission always means 1.0; saved voice speed is not inherited. Sync, async and HTTP streaming support this parameter; Realtime does not.

package/dist/client.js

@@ -1727,12 +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, "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

@@ -230,6 +230,7 @@ export interface VoiceSettings {
     similarityBoost?: number;
     style?: number;
     useSpeakerBoost?: boolean;
+    /** Request-only, pitch-preserving HTTP TTS speed (0.5–2.0). Omitted means 1.0. */
     speed?: number;
     guidanceScale?: number | null;
 }
@@ -300,6 +301,7 @@ export interface Model {
 }
 export interface Voice {
     voiceId: string;
+    /** Account display name, including a personal alias for a saved public voice. */
     name: string;
     origin: string;
     voiceType: string;
@@ -390,9 +392,6 @@ export interface VoiceClonePreviewRequest {
     files?: Array<UploadData | UploadFile>;
     description?: string;
     removeBackgroundNoise?: boolean;
-    languageCode?: 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.14.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.14.0";
+export const SDK_VERSION = "0.16.0";
 export const SDK_NAME = "@breeze.blue/sdk";

package/dist/voice-metadata.d.ts

@@ -1,7 +1,7 @@
 export declare const VOICE_GENDER_CODES: readonly ["male", "female", "neutral"];
 export declare const VOICE_AGE_CODES: readonly ["child", "young", "middle_aged", "old"];
 export declare const VOICE_TONE_CODES: readonly ["warm", "calm", "bright", "gentle", "energetic", "authoritative", "sincere", "weary", "precise", "refined", "urgent", "friendly", "articulate", "steady", "playful", "compassionate", "reflective", "measured", "rhythmic", "passionate"];
-export declare const VOICE_LANGUAGE_CODES: readonly ["ar", "cs", "de", "el", "en", "es", "fi", "fr", "hi", "id", "it", "ja", "ko", "nl", "pl", "pt", "ro", "ru", "th", "tr", "uk", "vi", "zh"];
+export declare const VOICE_LANGUAGE_CODES: readonly ["af", "ar", "bg", "bn", "bs", "ca", "cs", "da", "de", "el", "en", "es", "et", "eu", "fa", "fi", "fr", "gl", "he", "hi", "hu", "id", "is", "it", "ja", "kn", "ko", "lt", "mr", "ms", "ne", "nl", "no", "pl", "pt", "ro", "ru", "sk", "sl", "sq", "sv", "sw", "ta", "te", "th", "tl", "tr", "uk", "ur", "vi", "zh"];
 export declare const VOICE_TONE_MAX_ITEMS: 3;
 export declare const VOICE_ACCENT_CODES_BY_LANGUAGE: {
     readonly en: readonly ["american", "british", "scottish", "irish", "australian", "canadian", "us_southern", "us_new_york", "indian", "south_african", "russian", "japanese", "korean", "chinese"];

package/dist/voice-metadata.js

@@ -2,7 +2,7 @@
 export const VOICE_GENDER_CODES = ["male", "female", "neutral"];
 export const VOICE_AGE_CODES = ["child", "young", "middle_aged", "old"];
 export const VOICE_TONE_CODES = ["warm", "calm", "bright", "gentle", "energetic", "authoritative", "sincere", "weary", "precise", "refined", "urgent", "friendly", "articulate", "steady", "playful", "compassionate", "reflective", "measured", "rhythmic", "passionate"];
-export const VOICE_LANGUAGE_CODES = ["ar", "cs", "de", "el", "en", "es", "fi", "fr", "hi", "id", "it", "ja", "ko", "nl", "pl", "pt", "ro", "ru", "th", "tr", "uk", "vi", "zh"];
+export const VOICE_LANGUAGE_CODES = ["af", "ar", "bg", "bn", "bs", "ca", "cs", "da", "de", "el", "en", "es", "et", "eu", "fa", "fi", "fr", "gl", "he", "hi", "hu", "id", "is", "it", "ja", "kn", "ko", "lt", "mr", "ms", "ne", "nl", "no", "pl", "pt", "ro", "ru", "sk", "sl", "sq", "sv", "sw", "ta", "te", "th", "tl", "tr", "uk", "ur", "vi", "zh"];
 export const VOICE_TONE_MAX_ITEMS = 3;
 export const VOICE_ACCENT_CODES_BY_LANGUAGE = {
     en: ["american", "british", "scottish", "irish", "australian", "canadian", "us_southern", "us_new_york", "indian", "south_african", "russian", "japanese", "korean", "chinese"],

package/package.json

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