generate_captions
PRE-FETCH (mandatory): resources/read kubeez://skills/media-upload AND kubeez://skills/billing-confirmation. Captions are billed per-second — preview cost first.
Caption a video end to end: transcribes the speech, then burns word-timed captions onto the video server-side and returns a finished MP4. Captions are styled automatically and placed to avoid faces, on-screen text, and the main subject. Scope: generate:media. USE 'auto-caption' AS THE MODEL ID EVERYWHERE — upload and estimate both take it, and estimate returns the COMPLETE price in one call. Internally the job bills two per-second lines (speech-to-text, then the burn-in render) and estimate already sums both, itemized under breakdown; do NOT add a second estimate on top or you will double-quote. The render fee is credit-checked BEFORE transcription runs, so an unaffordable job never bills a partial step. Max 30 minutes per video. CANONICAL FLOW: (1) if the user has a local file, call get_upload_url(model_id='auto-caption'). (2) after upload, get_upload_session(token) returns total_video_seconds. (3) estimate(model='auto-caption', reference_video_seconds=<total_video_seconds>) — this is the full price. (4) quote it, ask for go-ahead. (5) only then call this tool. Required: media_url — a public HTTPS URL of the uploaded video. Optional: quality — 'auto' (default, auto-detects language, cheaper) or 'best' (specify a known language for higher accuracy). When quality='best', pass language as one of en/es/fr/de/it/pt. Optional: code_switching — true if the video mixes multiple spoken languages in one track. Optional manual placement (defaults to automatic content-aware placement): caption_x / caption_y — percent offsets of the caption block's center from the video center (x negative = left, y positive = down; y=18 is the standard lower zone); caption_scale — absolute caption size multiplier. Pass these ONLY when the user positioned the captions themselves. Async: returns {generation_id, status: 'processing', credits_charged} immediately. Poll get_generation(generation_id) until the captioned video appears in outputs.
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": {
"media_url": "<media_url>"
},
"name": "generate_captions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quality | No | auto | |
| language | No | ||
| caption_x | No | ||
| caption_y | No | ||
| media_url | Yes | ||
| caption_scale | No | ||
| code_switching | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||