Documentation

Voices & Languages

Choose how your agent sounds and which languages it can speak. Voices are provided by text-to-speech (TTS) engines; each voice has an ID you set on the agent. This page shows how to browse the catalog and apply your choice.

Languages

Pass a list of language codes in languages when you create or update an agent — for example ["en", "hi", "es"]. The agent can understand and respond in any listed language. Fetch the full list of supported languages from GET /api/providers/languages.

Voice (TTS)

Set the voice object with a provider, a voice_id, and an optional speed. Voice IDs are specific to each provider.

cURL
curl -X PUT "https://bkbharatai.blutec.ai/api/agents/AGENT_ID" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "languages": ["en", "hi"],
    "voice": {
      "provider": "google",
      "voice_id": "en-in-Chirp3-HD-Despina",
      "speed": 1.0
    }
  }'

Browse the catalog

Use the Providers API to discover voice IDs and supported languages before configuring an agent. In the dashboard, the voice picker on the agent's Call Configuration tab lets you preview and select voices without writing code.

cURL
# List available voices to find a voice_id
curl -X GET "https://bkbharatai.blutec.ai/api/providers/voices?provider=eleven_labs&page=1&page_size=20" \
  -H "Authorization: Bearer YOUR_JWT"

# List supported languages
curl -X GET "https://bkbharatai.blutec.ai/api/providers/languages" \
  -H "Authorization: Bearer YOUR_JWT"

Tips

  • Match the voice's language and accent to your primary audience for the most natural sound.
  • Keep speed near 1.0; small adjustments read more naturally than large ones.
  • List a caller's likely languages so the agent can switch smoothly mid-call.

Reference: Providers API · Agent API