cinematic_ads_export
Build the final video from the finished clips: captions, app mark/watermark, end card, lesson cards, answer marks, cutaways. SPENDS CREDITS (use price_only to quote). Takes a few minutes; the same options twice reuse the build. Fixes of moments that are ready (cinematic_ads_fix_moment) go into the next build. When exports[0].status is 'done', exports[0].url is the video. Long steps answer {status:'running'} after about a minute and keep going on the server — then poll cinematic_ads_get_project; never start the same step again while it runs.
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": {
"project_id": "<project_id>"
},
"name": "cinematic_ads_export"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | new = the remake; compare = side by side with the source. | new |
| options | No | Optional finish options, as in the studio: captions {enabled, style clean|boxed|highlight|karaoke (karaoke: white words, the one being said lit yellow, word by word), position top|upper-third|middle|lower-third|bottom, speakerNames, boxOpacity 0.2-1 in tenths (the box behind boxed captions), boxRadius 0-1 (its roundness: 0 square, 1 pill), language (write the captions in another language than the one spoken, e.g. "vi"; translated at build time)}, watermark {enabled, motion static|moving (static: the app icon in a corner; moving: text drifting across the frame), text (the moving words, up to 40 characters; default the app name), speed slow|medium|fast (of a moving mark), position top-left|top-right|bottom-left|bottom-right (of a static mark), size small|medium|large, opacity 0.2-1}, endCard {enabled}, lessonCards {enabled, size small|medium|large, placements {"<start ms>": {x, y, scale}}: textboxes are placed off faces automatically; placements pins one textbox by its start (centre x, y as 0-1 of the frame, scale 0.5-1.5)}, answerMarks {enabled}, seams {enabled}. Omit for the defaults — or, for a project made with Duplicate or from a video template, the choices its source last built with (a whole section left out takes those). A watermark field left out takes the watermark of the brand preset or template applied to the project (project.brand.watermark — e.g. preset:langla: moving "LangLa", medium speed), so send only what the user asked to change (e.g. {"watermark": {"speed": "fast"}} or {"watermark": {"enabled": false}}). | |
| price_only | No | Only return the price in credits; start nothing, spend nothing. | |
| project_id | Yes | Project id from cinematic_ads_list_projects or cinematic_ads_create_project. |