Voices & Languages

Your agent's voice is the first thing users hear. Vozzo provides a wide library of natural-sounding voices across multiple languages and accents, with support for custom voice cloning.

How Voice Selection Works

Voice availability depends on two chained selections:

1. Model (vz_model_id) — determines which languages are available
2. Language (agent_language) — determines which voices and accents are available
3. Voice (voice_id) — the specific voice persona

This dependency chain ensures you always select a voice that is compatible with your chosen AI pipeline.

Step 1 — Fetch Master Data

cURL
 
curl -X GET https://backend.vozzo.ai/master/master-data \
  -H "Authorization: Token YOUR_API_KEY"

Code
 
{
  "data": {
    "vz_models": [
      { "vz_model_id": 1, "vz_model_name": "orbit" },
      { "vz_model_id": 2, "vz_model_name": "quantum" }
    ],
    "languages": [
      {
        "lang_id": 1,
        "lang_name": "English",
        "vz_model_id": [1, 2]
      },
      {
        "lang_id": 2,
        "lang_name": "Hindi",
        "vz_model_id": [2]
      }
    ]
  }
}

Note: vz_model_id in the language object is an array — a language may be supported by multiple models.

Step 2 — Fetch Voices by Language

cURL
 
curl -X GET "https://backend.vozzo.ai/voices/explore-voices/?lang_id=1" \
  -H "Authorization: Token YOUR_API_KEY"

Code
 
{
  "data": [
    {
      "voice_id": 935,
      "name": "Sarah",
      "country": "US",
      "gender": "Female",
      "description": "Warm and professional American voice",
      "provider": "ElevenLabs",
      "provider_id": 2,
      "sample_recording": "https://cdn.vozzo.ai/voices/sarah-sample.mp3",
      "lang_id": 1,
      "lang_name": "English",
      "is_cloned": false
    }
  ]
}

Voice Object Reference

Setting Voice on an Agent

cURL
 
curl -X PUT https://backend.vozzo.ai/agent/update-agent/{agent_uuid}/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_language": "English",
    "agent_accent": "American",
    "voice_id": 12
  }'

Key fields

Supported Languages (Sample)

Fetch the live list via /master/master-data — this table reflects the current production state.

Voice Cloning

Vozzo supports cloning your own voice using ElevenLabs or Cartesia as the underlying provider.

Code
 
# Clone via ElevenLabs
curl -X POST https://backend.vozzo.ai/voice-cloning/elevenlabs/clone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "audio_file=@my_voice_sample.mp3" \
  -F "voice_name=My Custom Voice"

# Clone via Cartesia
curl -X POST https://backend.vozzo.ai/voice-cloning/cartesia/clone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "audio_file=@my_voice_sample.mp3" \
  -F "voice_name=My Custom Voice"

Cloned voices appear in the voices list with "is_cloned": true and can be assigned to any agent.

Best Practices