Voices

Use preset voices, reference audio, or reusable custom voices with Higgs TTS 3.

Choose a preset voice, clone a voice from reference audio, or create a reusable custom voice.

Preset voices

Voice	Style	Sample input	Sample audio
chloe	A friendly and clear female voice with an engaging, informative tone and a standard American accent.	<|emotion:amusement|>Hi, I'm Chloe Adams! <|emotion:enthusiasm|>I love showing you the little tricks that make everything click so much faster. <|prosody:pause|> Ready? Let's jump right in and make this easy and fun.
eleanor	A calm, articulate female voice with a clear, professional Standard American English accent, perfect for educational or explanatory content.	<|emotion:contentment|>Hello, I'm Eleanor Reed. I love making tricky ideas feel simple and easy to follow. <|prosody:speed_slow|>We'll take it one step at a time, no rushing. <|emotion:awe|>And honestly, there's something wonderful about the moment when it all clicks.
jake	A male speaker with an energetic and slightly dramatic tone, conveying passion and enthusiasm, especially about sports.	<|emotion:enthusiasm|>What's up, I'm Jake Rivers! <|emotion:elation|>I live for the big moments, the buzzer-beaters, the comebacks, the whole roller coaster. <|sfx:laughter|>Haha, win or lose, I'm all in, and trust me, I bring the energy every single time!
marcus	A male speaker with an enthusiastic, confident, and slightly professorial American delivery.	<|emotion:enthusiasm|>Hello, I'm Marcus Webb, and I genuinely get excited about ideas. <|emotion:elation|>Give me any topic and I'll happily walk you through it like it's the most fascinating thing in the world. <|sfx:laughter|>Haha, fair warning, I do tend to ramble when something's interesting!
nora	A female speaker with a calm, clear, and narrative voice, using standard American English.	<|emotion:contentment|>Hi there, I'm Nora Vance. I have a soft spot for stories <|prosody:pause|> the kind that pull you in slowly. <|prosody:speed_slow|>So settle in, and let me paint you a little picture of wherever we're headed.
oliver	A calm, articulate male voice with a thoughtful American accent, well-suited for explanatory or reflective content.	<|emotion:contemplation|>Hi, I'm Oliver Grant. I tend to think out loud, slowly working my way toward what really matters. <|prosody:pause|> Self-awareness, meaning, the quiet questions, that's where I like to linger. <|emotion:contentment|>Pull up a chair and let's reflect together.

Use voice to select a preset speaker.

cURL

curl https://api.boson.ai/v1/audio/speech \
  -H "Authorization: Bearer $BOSON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "higgs-tts-3",
    "input": "Hello, this is a test.",
    "voice": "berlinda"
  }' \
  --output out.mp3

Reference voice

Clone a voice instantly with ref_audio and ref_text.

cURL

curl https://api.boson.ai/v1/audio/speech \
  -H "Authorization: Bearer $BOSON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "higgs-tts-3",
    "input": "Hello, this is a test.",
    "ref_audio": "https://docs.boson.ai/public/audio/sample.mp3",
    "ref_text": "Same voice, same words, and uh, a completely different presence. I was built for chat native voice, real-time, expressive, and controllable."
  }' \
  --output out.mp3

ref_audio can be a URL or the base64-encoded bytes of a local audio file. Supported formats are wav, mp3, opus, pcm and flac.

We recommend 5-30 seconds of clean speech, with no music or background voices. Although ref_text is optional, we recommend providing a verbatim transcript of the reference audio, including filler words.

You must own the right to clone the voice.

Custom voices

Custom voices work like reference voices, but you can reuse the returned voice ID instead of sending ref_audio on every request.

First, create a voice ID from reference audio and text. Then pass that ID to voice, just like a preset voice.

cURL

# 1) Create a reusable voice from reference audio — returns a voice_id.
curl https://api.boson.ai/v1/audio/voices \
  -H "Authorization: Bearer $BOSON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ref_audio": "https://docs.boson.ai/public/audio/sample.mp3",
    "ref_text": "Same voice, same words, and uh, a completely different presence. I was built for chat native voice, real-time, expressive, and controllable.",
    "title": "My Voice"
  }'
# => {"voice_id": "voice_abc123...", "title": "My Voice", "created_at": "...", "ref_text": "..."}

# 2) Reuse it on any request by passing the voice_id to "voice".
curl https://api.boson.ai/v1/audio/speech \
  -H "Authorization: Bearer $BOSON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "higgs-tts-3",
    "input": "Using my saved voice.",
    "voice": "voice_abc123..."
  }' \
  --output out.mp3

ref_audio accepts a URL or the base64-encoded bytes of a local file. Reusing the same audio returns the same voice_id, so creating a voice is safe to repeat.

Deleting a custom voice

DELETE /v1/audio/voices/{voice_id} removes the reference audio for one of your own voices. The voice stops working on /v1/audio/speech and disappears from GET /v1/audio/voices.

cURL

curl -X DELETE https://api.boson.ai/v1/audio/voices/voice_abc123... \
  -H "Authorization: Bearer $BOSON_API_KEY"
# => {"voice_id": "voice_abc123...", "object": "voice", "deleted": true}

A few things to know:

• You can only delete voices you created. Deleting a voice that does not exist, belongs to another key, or was already deleted all return 404 voice_not_found — the three are not distinguished, so no key can use this endpoint to discover another account’s voice IDs.
• Preset voices cannot be deleted and return 403 voice_not_deletable.
• Deleting is not reversible, but it is not destructive either: because voice_id is derived from the audio itself, re-creating the voice with the same ref_audio gives you back the same voice_id.