Video Url Transcription
video_url_transcriptionTranscribe video from URL to text using Whisper models.
Extracts audio from video URL and converts it to text transcription with optional timestamps. Supports YouTube, Twitter/X, Twitch, Kick and TikTok videos. Automatically polls until transcription is complete.
Available models:
WhisperLargeV3Ct2: ts_level: segment|word, diarize, output=json (text + segments)WhisperLargeV3: ts_level: segment
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": {
"video_url": "<video_url>",
"include_ts": "<include_ts>"
},
"name": "video_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 | |
| video_url | Yes | URL of video to transcribe. Supports YouTube (e.g., 'https://www.youtube.com/watch?v=...'), Twitter/X (e.g., 'https://twitter.com/user/status/...' or 'https://x.com/user/status/...'), Twitch (e.g., 'https://www.twitch.tv/videos/...'), Kick (e.g., 'https://kick.com/video/...') and TikTok. A Twitter Spaces link is routed to audio transcription automatically | |
| 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 | |||