Design a new synthetic voice from a description plus preview text.
Authenticate with the X-API-Key request header.
List price. Volume / bulk customers get a discounted rate — contact us for account pricing.
| Name | Type | Required | Description | Default / options |
|---|---|---|---|---|
| voice_description | string | required | Description of the desired voice. | — |
| text | string | optional | Preview text the designed voice speaks (100-1000 chars). Required unless auto_generate_text is true. | — |
| model_id | string | optional | Voice design model (eleven_multilingual_ttv_v2, eleven_ttv_v3). | default: eleven_multilingual_ttv_v2 |
| auto_generate_text | boolean | optional | Auto-generate preview text from the description. | default: false |
| loudness | number | optional | Output loudness (-1 to 1). | default: 0.5 |
| seed | number | optional | Deterministic seed (0-4294967295). | — |
| guidance_scale | number | optional | Prompt adherence. | default: 5 |
| quality | number | optional | Output quality vs variety (-1 to 1). | — |
| output_format | string | optional | Audio output format (e.g. mp3_44100_128). | default: mp3_44100_128 |
curl -X POST https://brahmand-api.bulletshorts.co/v1/audio/elevenlabs-voice-design \
-H "X-API-Key: $TRINETRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"voice_description":"A warm, gravelly older male narrator with a slight British accent","text":"In a time long forgotten, when the mountains were young and the rivers ran clear, there lived a storyteller whose voice could calm the wildest of storms and stir the quietest of hearts to courage."}'{
"voice_description": "A warm, gravelly older male narrator with a slight British accent",
"text": "In a time long forgotten, when the mountains were young and the rivers ran clear, there lived a storyteller whose voice could calm the wildest of storms and stir the quietest of hearts to courage."
}Submitting a job returns 202 Accepted with a job id. Poll GET /v1/jobs/{id} until the job reaches a terminal state, or register a webhook to be notified.
{
"job_id": "job_elevenlabsvoicedesign_a1b2c3",
"status": "queued"
}{
"id": "job_elevenlabsvoicedesign_a1b2c3",
"model": "elevenlabs-voice-design",
"status": "succeeded",
"output": {
"outputs": [
{
"url": "https://cdn.trinetra.ai/out/elevenlabs-voice-design/a1b2c3.mp3",
"type": "audio"
}
]
},
"credits_charged": 10
}Webhook: set a webhook_url on your API key to receive a POST with the terminal job document instead of polling.