elevenlabs/speech-to-text
Speech To Text by ElevenLabs - accurate speech-to-text transcription with AI. Convert audio and video to text with high accuracy, multilingual support, and speaker identification.
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runelevenlabs/speech-to-textInput Schema
4 parameters · 0 required · 4 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
audio | string | Optional | URL of the audio file to transcribe |
diarize | boolean | Optional | Whether to annotate who is speaking · Default: true |
language_code | string | Optional | Language code of the audio |
tag_audio_events | boolean | Optional | Tag audio events like laughter, applause, etc. · Default: true |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "elevenlabs/speech-to-text",
"audio": "https://static.sandbase.ai/examples/elevenlabs/speech-to-text/output_url_0.mp3",
"diarize": true,
"language_code": "eng",
"tag_audio_events": true,
"prompt": "a beautiful sunset over mountains"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
ElevenLabs Speech to Text
elevenlabs/speech-to-text converts recorded speech into a reusable transcript for search, captions, analysis, and downstream content workflows. The service supports language-aware recognition, optional speaker separation, and audio-event detection, helping preserve conversational structure and relevant context from interviews or meetings. This combination makes the model a practical choice when the creative outcome depends on those qualities rather than on a generic media conversion.
For production work, Its downloadable result suits pipelines that want a transcription artifact to store or process after the asynchronous job completes, rather than only displaying a short inline string. The result is most reliable when the source material and creative brief clearly describe the intended subject, progression, visual or sonic character, and the qualities that must remain unchanged.
Highlights
Recorded-speech recognition turns audio into searchable and editable language data.
Speaker separation distinguishes voices across conversations and interviews.
Audio-event awareness captures relevant sounds beyond spoken words.
Language-aware transcription supports recordings produced for multilingual audiences.
Pricing
| Billing unit | Price |
|---|---|
| Per request | $0.03 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The model's named workflow matches the source material and intended output | A different input modality or model route is required |
| A managed asynchronous result is suitable for the production pipeline | A synchronous, interactive editor is essential |
| The documented controls cover the required duration, framing, or format | The project needs controls outside this endpoint's schema |
| Creative iteration benefits from a repeatable request structure | Exact deterministic pixels, frames, geometry, or samples are mandatory |
| A finished downloadable media asset is the desired deliverable | Editable source layers or a native project file are required |
Prompt Guide
For audio transformation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.
{
"audio": "https://static.sandbase.ai/examples/elevenlabs/speech-to-text/output_url_0.mp3"
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | elevenlabs/speech-to-text |
| Inputs | audio, diarize, language_code, tag_audio_events |
| Required inputs | None |
| Output fields | content_type, url |
| Execution | Async (submit, then poll for result) |