Transcribe and index media
ingestTranscribe a YouTube video, podcast episode (Apple Podcasts, Spotify-with-RSS, RSS, Buzzsprout, Libsyn, etc.) and add it to the user's searchable library. Already-transcribed media returns instantly at no cost. Otherwise it runs as a job: waits up to wait_seconds, then returns status "queued"/"running" — poll get_job. quality "premium" re-transcribes with high-accuracy ASR when the account's plan includes it (best for multi-speaker interviews). Charged by route: captions 0.5 credits, ASR 20/hr, AI video 36/hr, podcasts 10/hr; worst case is reserved up front and the difference refunded.
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>"
},
"name": "ingest"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | YouTube video URL or podcast episode URL (or a yt: item id) | |
| quality | No | standard | |
| wait_seconds | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| next | Yes | ||
| error | No | ||
| job_id | No | ||
| result | No | ||
| status | Yes | ||
| item_id | Yes | ||
| quality | No |