transcribe
Submit a YouTube or TikTok URL to create a transcription job, choosing captions-only, automatic captions-or-AI, or AI-only processing.
Instructions
Submit a YouTube or TikTok URL to TranscriptDock and return the created job. captions_only costs 1 credit; auto uses captions when the video has them (1 credit) and AI transcription otherwise; transcribe always runs AI transcription (2 credits per started minute, paid plans).
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": {
"url": "<url>",
"idempotency_key": "<idempotency_key>"
},
"name": "transcribe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | YouTube or TikTok video URL. | |
| mode | No | Default captions_only (1 credit). auto: captions if present, else AI transcription. transcribe: always AI transcription (2 credits per started minute). | |
| language | No | Spoken language hint for AI transcription (BCP 47, e.g. en). Omit to auto detect. | |
| max_credits | No | Cap for one AI transcription job; the job fails with BUDGET_EXCEEDED before any charge if the measured cost is higher. | |
| idempotency_key | Yes | Stable printable ASCII key for this submission. |