Transcribe speech from an audio file to 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 |
|---|---|---|---|---|
| audio_url | string | required | Source audio to transcribe. | — |
| model_id | string | optional | STT model id (scribe_v1). | default: scribe_v1 |
| language_code | string | optional | ISO 639-1/3 language code; auto-detected if omitted. | — |
| tag_audio_events | boolean | optional | Tag non-speech events (laughter, etc). | default: true |
| num_speakers | number | optional | Hint for number of speakers (1-32). | — |
| timestamps_granularity | string | optional | Timestamp granularity: none, word, character. | default: word |
| diarize | boolean | optional | Annotate which speaker is talking. | default: false |
curl -X POST https://brahmand-api.bulletshorts.co/v1/audio/elevenlabs-stt \
-H "X-API-Key: $TRINETRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audio_url":"https://example.com/talk.mp3"}'{
"audio_url": "https://example.com/talk.mp3"
}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_elevenlabsstt_a1b2c3",
"status": "queued"
}{
"id": "job_elevenlabsstt_a1b2c3",
"model": "elevenlabs-stt",
"status": "succeeded",
"output": {
"outputs": [
{
"url": "https://cdn.trinetra.ai/out/elevenlabs-stt/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.