@breeze.blue/sdk 0.13.0 → 0.15.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 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
+  and current Key Budget counters before starting work.
+
 ## 0.13.0
 
 - `voices.random(...)` accepts optional `languageCode` and `voiceType`

package/README.md

@@ -530,6 +530,8 @@ language-to-accent cascade at runtime.
 ```ts
 const models = await client.models.list();
 const balance = await client.account.balance();
+const currentKey = (await client.account.currentApiKey()).apiKey;
+console.log(currentKey.status, currentKey.creditRemaining);
 const usage = await client.account.usage({ days: 7 });
 const keyUsage = await client.account.usage({
   apiKeyId: "key_01hprod",
@@ -571,3 +573,9 @@ 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.
+
+### 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.d.ts

@@ -1,5 +1,5 @@
 import { AudioResponse } from "./audio.js";
-import type { AudioRequestOptions, BreezeBlueWebSocket, AsyncTextToSpeechJob, Balance, BreezeBlueClientOptions, GenericStatus, GenerationJob, HistoryItem, HistoryList, HistoryListParams, Model, RequestOptions, RealtimeTextToSpeechConnectOptions, RealtimeTextToSpeechEvent, RealtimeTextToSpeechManagedConnectOptions, RealtimeTextToSpeechMessage, RealtimeTextToSpeechSession, RealtimeTextToSpeechSessionRequest, SavedVoice, SaveVoiceRequest, StreamTextToSpeechOptions, TextToSpeechRequest, TtsEnhanceRequest, TtsEnhanceResponse, Usage, UsageParams, Voice, VoiceClonePreview, VoiceClonePreviewRequest, VoiceDesignRequest, VoiceDesignResponse, VoiceDesignStreamRequest, VoiceEditRequest, VoiceList, VoiceMetadataOptions, VoiceRandomParams, VoiceSearchParams, VoiceSettings } from "./types.js";
+import type { AudioRequestOptions, BreezeBlueWebSocket, AsyncTextToSpeechJob, Balance, BreezeBlueClientOptions, CurrentApiKeyResponse, GenericStatus, GenerationJob, HistoryItem, HistoryList, HistoryListParams, Model, RequestOptions, RealtimeTextToSpeechConnectOptions, RealtimeTextToSpeechEvent, RealtimeTextToSpeechManagedConnectOptions, RealtimeTextToSpeechMessage, RealtimeTextToSpeechSession, RealtimeTextToSpeechSessionRequest, SavedVoice, SaveVoiceRequest, StreamTextToSpeechOptions, TextToSpeechRequest, TtsEnhanceRequest, TtsEnhanceResponse, Usage, UsageParams, Voice, VoiceClonePreview, VoiceClonePreviewRequest, VoiceDesignRequest, VoiceDesignResponse, VoiceDesignStreamRequest, VoiceEditRequest, VoiceList, VoiceMetadataOptions, VoiceRandomParams, VoiceSearchParams, VoiceSettings } from "./types.js";
 export declare class BreezeBlueClient {
     readonly apiKey: string | undefined;
     readonly baseUrl: string;
@@ -267,6 +267,8 @@ declare class AccountResource {
     private readonly client;
     constructor(client: BreezeBlueClient);
     balance(options?: RequestOptions): Promise<Balance>;
+    /** Return the authenticating API key and its current Key Budget counters. */
+    currentApiKey(options?: RequestOptions): Promise<CurrentApiKeyResponse>;
     usage(params?: UsageParams, options?: RequestOptions): Promise<Usage>;
 }
 export {};

package/dist/client.js

@@ -1625,6 +1625,10 @@ class AccountResource {
     balance(options) {
         return this.client.requestJson("GET", "/v1/balance", undefined, undefined, options);
     }
+    /** Return the authenticating API key and its current Key Budget counters. */
+    currentApiKey(options) {
+        return this.client.requestJson("GET", "/v1/api-keys/current", undefined, undefined, options);
+    }
     usage(params = {}, options) {
         return this.client.requestJson("GET", "/v1/usage", params, undefined, options);
     }
@@ -1727,6 +1731,7 @@ function clonePreviewForm(request) {
     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 })) {

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,7 +392,10 @@ 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;
 }
@@ -508,6 +513,19 @@ export interface Balance {
     topups: BalanceTopup[];
     [key: string]: unknown;
 }
+export interface CurrentApiKey {
+    id: string;
+    name: string;
+    prefix: string;
+    status: string;
+    creditLimit?: number | null;
+    creditUsed?: number;
+    creditReserved?: number;
+    creditRemaining?: number | null;
+}
+export interface CurrentApiKeyResponse {
+    apiKey: CurrentApiKey;
+}
 export interface UsageSummary {
     requestCount: number;
     totalTextCharacters: number;

package/dist/version.d.ts

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

package/dist/version.js

@@ -1,2 +1,2 @@
-export const SDK_VERSION = "0.13.0";
+export const SDK_VERSION = "0.15.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.13.0",
+  "version": "0.15.0",
   "description": "ESM-first TypeScript SDK for the Breeze Blue Developer API.",
   "license": "MIT",
   "author": "Breeze Blue <support@breezeblue.ai>",