cURL
curl \
--request POST \
--url "https://api.breeze.blue/v1/voice-previews/clone" \
--header "xi-api-key: $BREEZE_API_KEY" \
--form "name=Brand Narrator" \
--form "description=Clean studio narration sample." \
--form "[email protected];type=audio/wav"from pathlib import Path
import os
from breeze_blue import BreezeBlue
client = BreezeBlue(api_key=os.environ["BREEZE_API_KEY"])
preview = client.voices.create_clone_preview(
name="Brand Narrator",
file=Path("sample.wav"),
description="Clean studio narration sample.",
)
print(preview["generated_voice_id"])import { readFile } from "node:fs/promises";
import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient({
apiKey: process.env.BREEZE_API_KEY!,
});
const preview = await client.voices.createClonePreview({
name: "Brand Narrator",
file: {
data: await readFile("sample.wav"),
filename: "sample.wav",
contentType: "audio/wav",
},
description: "Clean studio narration sample.",
});
console.log(preview.generatedVoiceId);{
"generated_voice_id": "<string>",
"requires_verification": false
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}Voice Previews
Create clone preview
Upload one reference sample and create a temporary voice clone preview. Breeze detects the spoken language and automatically generates the preview script in that language. Custom text, instructions, and language hints are not accepted.
POST
/
v1
/
voice-previews
/
clone
cURL
curl \
--request POST \
--url "https://api.breeze.blue/v1/voice-previews/clone" \
--header "xi-api-key: $BREEZE_API_KEY" \
--form "name=Brand Narrator" \
--form "description=Clean studio narration sample." \
--form "[email protected];type=audio/wav"from pathlib import Path
import os
from breeze_blue import BreezeBlue
client = BreezeBlue(api_key=os.environ["BREEZE_API_KEY"])
preview = client.voices.create_clone_preview(
name="Brand Narrator",
file=Path("sample.wav"),
description="Clean studio narration sample.",
)
print(preview["generated_voice_id"])import { readFile } from "node:fs/promises";
import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient({
apiKey: process.env.BREEZE_API_KEY!,
});
const preview = await client.voices.createClonePreview({
name: "Brand Narrator",
file: {
data: await readFile("sample.wav"),
filename: "sample.wav",
contentType: "audio/wav",
},
description: "Clean studio narration sample.",
});
console.log(preview.generatedVoiceId);{
"generated_voice_id": "<string>",
"requires_verification": false
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}{
"code": "<string>",
"detail": "<string>",
"error": "<string>",
"ok": false,
"meta": {}
}Continue building
Cloning a voice
Prepare reference audio and audition the result.
Download completed voice preview
Download the completed preview.
Save voice preview
Save the preview before using it for TTS.
Authorizations
Breeze Developer API key.
Body
multipart/form-data

