Scribe v3
scribe_v3Transcribe audio and video to text with Scribe v3 from ElevenLabs through one Spiral API key. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.004335 per run at the default inputs for 60 seconds of input.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- Longest run, end to end
- 930 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
file | URL or file | — | A link to the audio or video file to transcribe (a Toolbox file link or a public https URL), sent to ElevenLabs as the file. At least 100 ms of audio and at most 500 MB; give a larger file as |
seed | number (whole) 0 to 2147483647 | — | If specified, our system will make a best effort to sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed. Must be an integer between 0 and 2147483647. |
diarize | true or false | false | Whether to annotate which speaker is currently talking in the uploaded file. |
source_url | URL or file | — | The URL of an audio or video file for ElevenLabs to fetch and transcribe: hosted audio or video files, YouTube and TikTok video URLs and other video hosting services. Exactly one of |
file_format | one of pcm_s16le_16, other | other | The format of input audio. Options are 'pcm_s16le_16' or 'other' For |
no_verbatim | true or false | false | If true, the transcription will not have any filler words, false starts and non-speech sounds. Only supported with scribe_v2 model. |
temperature | number 0 to 2 | — | Controls the randomness of the transcription output. Accepts values between 0.0 and 2.0, where higher values result in more diverse and less deterministic results. If omitted, we will use a temperature based on the model you selected which is usually 0. |
num_speakers | number (whole) 1 to 32 | — | The maximum amount of speakers talking in the uploaded file. Can help with predicting who speaks when. The maximum amount of speakers that can be predicted is 32. Defaults to null, in this case the amount of speakers is set to the maximum value the model supports. |
language_code | text | — | An ISO-639-1 or ISO-639-3 language_code corresponding to the language of the audio file. Can sometimes improve transcription performance if known beforehand. Defaults to null, in this case the language is predicted automatically. |
tag_audio_events | true or false | true | Whether to tag audio events like (laughter), (footsteps), etc. in the transcription. |
use_multi_channel | true or false | false | Whether the audio file contains multiple channels where each channel contains a single speaker. When enabled, each channel is transcribed independently. By default a separate transcript is returned per channel; set multichannel_output_style='combined' to instead receive a single transcript with all channels merged and sorted by time. Each word in the response includes a 'channel_index' field indicating which channel it was spoken on. A maximum of 5 channels is supported. Each channel is billed independently at the full audio duration, so cost scales linearly with the number of channels. |
detect_speaker_roles | true or false | false | Whether to detect speaker roles (agent vs customer). Requires diarize=true. Cannot be used with use_multi_channel=true. When enabled, speaker_id values will be 'agent' and 'customer' instead of 'speaker_0', 'speaker_1', etc. Usage incurs an additional 10% surcharge on base transcription cost. |
diarization_threshold | number 0.1 to 0.4 | — | Diarization threshold to apply during speaker diarization. A higher value means there will be a lower chance of one speaker being diarized as two different speakers but also a higher chance of two different speakers being diarized as one speaker (less total speakers predicted). A low value means there will be a higher chance of one speaker being diarized as two different speakers but also a lower chance of two different speakers being diarized as one speaker (more total speakers predicted). Can only be set when diarize=True and num_speakers=None. Defaults to None, in which case we will choose a threshold based on the model_id (0.22 usually). |
timestamps_granularity | one of none, word, character | word | The granularity of the timestamps in the transcription. 'word' provides word-level timestamps and 'character' provides character-level timestamps per word. |
multichannel_output_style | one of separate, combined | separate | Controls the response shape when use_multi_channel is enabled. 'separate' (default) returns one transcript per channel under 'transcripts'. 'combined' merges all channels into a single transcript whose words are sorted by start time, each carrying a 'channel_index' - matching the single-channel response shape. 'combined' requires timestamps (timestamps_granularity must not be 'none') and does not support entity detection or redaction. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "elevenlabs",
"model": "scribe_v3",
"input": {
"file": "<file>"
}
}'Frequently asked questions
How much does Scribe v3 cost?
$0.004335 per run at the default inputs for 60 seconds of input. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Scribe v3 through an API?
Send `POST /v1/runs` with `"provider": "elevenlabs"`, `"model": "scribe_v3"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with ElevenLabs to use Scribe v3?
No. Spiral runs it on its own ElevenLabs account and charges your Spiral balance.
Can my AI agent use Scribe v3?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.