- Call
POST /v1/voice-previews/designwith a description and sample script. The request returns onegenerated_voice_idpreview by default. - Pick the preview you like and call
POST /v1/voice-previews/{generated_voice_id}/saveto persist a real voice.
Step 1: Generate previews
Breeze bills by successful preview count times preview text character count.voice_description and text each accept up to 500 characters. Set preview_count to 3 when you want three candidates in one request.
Use guidance_scale to tune how strongly generation follows the voice description and preview script. Accepted values range from 1.0 to 10.0. When you pass it, that exact value is used. When you omit it, Breeze picks a random value between 1.0 and 10.0 for the request.
Step 2: Preview the audio
Each preview includes agenerated_voice_id. Stream the sample with GET /v1/voice-previews/{generated_voice_id}/stream or decode the audio_base_64 field returned in the design response.
Step 3: Persist the voice
language_code is omitted, Breeze reuses the generation language; legacy previews without language metadata fall back to en.
POST /v1/text-to-speech/{voice_id} and appears on the voices page in the console.
Continue building
Create design previews
Inspect
voice_description, text, preview_count, and guidance_scale with SDK examples.Save voice preview
Persist a
generated_voice_id as a reusable voice with a name and description.CLI voice design
Design, audition, and save voice previews from the terminal with
breeze voice design.Voices
Understand designed voices, saved voices, voice IDs, and persisted voice settings.
Text to speech
Use the saved
voice_id to generate sync, async, or streaming speech.Pricing
Estimate preview cost, generation concurrency, and shared Studio/API credits.

