Audio Url Transcription
audio_url_transcriptionConvert Twitter Spaces audio URLs into text transcripts using Whisper models, with optional timestamps, speaker labels, and language selection. Use it to make Spaces recordings readable.
Instructions
Transcribe audio from Twitter Spaces URL to text using Whisper models.
Extracts and transcribes audio from Twitter Spaces URLs. NOTE: This endpoint only works with Twitter Spaces URLs. For video content, use video_url_transcription instead.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"audio_url": "<audio_url>",
"include_ts": "<include_ts>"
},
"name": "audio_url_transcription"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of the recording as an ISO code, e.g. 'en', 'pl'. Set it whenever you know the language: auto-detection can pick the wrong one, e.g. on short or accented audio. It forces the output language, so a wrong code returns a translation instead of a transcript. Auto-detected when unset | |
| model | No | Whisper model from the model list. Default WhisperLargeV3Ct2: honours lang, returns segments, supports diarize and word timestamps | WhisperLargeV3Ct2 |
| diarize | No | Label who is speaking; implies include_ts. Only on models marked 'diarize' in the model list (WhisperLargeV3 rejects it). Costs 1.5x, not stacked with a finer ts_level | |
| ts_level | No | Timestamp granularity: 'segment', 'word' or 'char'; implies include_ts. Only the levels a model lists under 'ts_level' in the model list are accepted (WhisperLargeV3: segment only). Finer than segment costs 1.5x on models that price it | |
| audio_url | Yes | URL of Twitter Spaces audio to transcribe (e.g., 'https://twitter.com/i/spaces/1nAKEERkeLbKL') | |
| include_ts | Yes | Include timestamps in transcription | |
| webhook_url | No | HTTPS URL for deAPI to call when this job finishes. Notifies your own systems; the tool still returns the result here | |
| webhook_secret | No | 32-255 char key deAPI signs the callback with (HMAC-SHA256). Needs webhook_url. A secret given in chat stays in the transcript | |
| include_metadata | No | Include source metadata in the result. Carries a flat surcharge on models that price it | |
| return_result_in_response | No | Return transcription inline. Set to False for large files to get download URL instead |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||