Add a graphic to a long video
add_graphicAdds a motion graphic to a long-form project, pinned to the transcript: it starts as the word at is said and ends with until (default its build plus 2 s). Checks the data against the template and, with check_against, every figure against the scene's script, before saving; then starts its render. Returns graphic_id, status (rendering, ready, failed with the error, or hidden with the reason), task_id for get_task, start_seconds and end_seconds in the finished video, and what to do next. Costs 1 credit per started 2 s of the graphic (3 full frame).
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>",
"template": "<template>",
"data": "<data>",
"at": "<at>"
},
"name": "add_graphic"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | Yes | The word it starts on, as { take_id, word } with the word's index from get_transcript | |
| data | Yes | The template's data, matching its data_schema in list_graphics | |
| beats | No | One word per step (a worked sum's lines or a timeline's markers), in order: each step appears as its word is said. null for the template's own timing | |
| until | No | The word it ends on; null for its build plus 2 s, at least 5 s (30 s at most) | |
| template | Yes | A template from list_graphics | |
| placement | No | full replaces the picture; right, left and band are overlays. Default the template's first (list_graphics lists them) | |
| project_id | Yes | From create_project | |
| check_against | No | A scene id (its script, else its take's transcript) or the script's text: every figure in the data must appear in it |