cURL
curl \
--request POST \
--url "https://api.breeze.blue/v1/voice-previews/localize" \
--header "xi-api-key: $BREEZE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"voice_id": "voc_xeh3w54cqvnp",
"language_code": "es",
"name": "Brand Narrator (Spanish)"
}'import os
from breeze_blue import BreezeBlue
client = BreezeBlue(api_key=os.environ["BREEZE_API_KEY"])
job = client.voices.create_localize_preview(
voice_id="voc_xeh3w54cqvnp",
language_code="es",
name="Brand Narrator (Spanish)",
)
print(job["generation_job_id"])import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient({
apiKey: process.env.BREEZE_API_KEY!,
});
const job = await client.voices.createLocalizePreview({
voiceId: "voc_xeh3w54cqvnp",
languageCode: "es",
name: "Brand Narrator (Spanish)",
});
console.log(job.generationJobId);{
"generation_job_id": "<string>",
"status": "<string>"
}{
"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 localize preview
Localize an existing voice into another speaking language and return a background job. Breeze keeps the source timbre and picks the preview script for the target language; poll the job and save the preview it produces.
POST
/
v1
/
voice-previews
/
localize
cURL
curl \
--request POST \
--url "https://api.breeze.blue/v1/voice-previews/localize" \
--header "xi-api-key: $BREEZE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"voice_id": "voc_xeh3w54cqvnp",
"language_code": "es",
"name": "Brand Narrator (Spanish)"
}'import os
from breeze_blue import BreezeBlue
client = BreezeBlue(api_key=os.environ["BREEZE_API_KEY"])
job = client.voices.create_localize_preview(
voice_id="voc_xeh3w54cqvnp",
language_code="es",
name="Brand Narrator (Spanish)",
)
print(job["generation_job_id"])import { BreezeBlueClient } from "@breeze.blue/sdk";
const client = new BreezeBlueClient({
apiKey: process.env.BREEZE_API_KEY!,
});
const job = await client.voices.createLocalizePreview({
voiceId: "voc_xeh3w54cqvnp",
languageCode: "es",
name: "Brand Narrator (Spanish)",
});
console.log(job.generationJobId);{
"generation_job_id": "<string>",
"status": "<string>"
}{
"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
Localizing a voice
Generate, audition, and save localized previews.
Get localize preview
Poll the returned localization job.
List Voice Metadata options
Check target language and accent codes.
Authorizations
Breeze Developer API key.
Body
application/json
Localize an existing voice into another supported speaking language.
Source voice to localize. See List voices.
Required string length:
1 - 64Target speaking language for the localized preview. See supported language codes.
Required string length:
2 - 16Display name for the preview. Defaults to the source voice name.
Required string length:
1 - 160