captions
Generate word-timed subtitles from narration audio for demo videos; returns a job ID immediately for polling and rejects concurrent runs.
Instructions
Transcribe narration.mp3 to captions with word timing. Returns a jobId immediately — poll job_status. Rejects if another job is running.
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": {
"dir": "<dir>"
},
"name": "captions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dir | Yes | demo project directory — pass an absolute path | |
| lang | No | render a language variant from scene.narrations[<code>] over the shared take (artifacts namespaced: audio/<code>/, captions.<code>.*, output/final-demo.<code>.mp4). Omit for the default single-language render. | |
| params | No | storyboard template params (name → value); each must be declared in the storyboard's params block. Substitutes {{name}} across all stages. | |
| offline | No | approximate captions from the script — no network/STT | |
| alignScript | No | use script spelling and punctuation with STT word timing |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| jobId | Yes | ||
| status | Yes | ||
| demoDir | Yes | resolved absolute demo directory | |
| logFile | Yes |