Suggest graphics for a scene
suggest_graphicsProposes up to max (default 3) motion graphics for one scene of a long-form project, from its script and its take's transcript: each with its template, data (every figure from the script), placement, the words it starts and ends on, its start and end in seconds in the finished video, and why. Nothing is saved: each proposal's add_with is the add_graphic arguments that add it as it is; dropped says what was left out and why. 2 credits a call: use estimate_only first and tell the person the price. model is any gateway "provider/model" (default google/gemini-2.5-flash-lite).
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>",
"scene_id": "<scene_id>"
},
"name": "suggest_graphics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max | No | At most how many graphics to propose, 1 to 5; default 3 | |
| model | No | Gateway "provider/model" id; default google/gemini-2.5-flash-lite, the cheapest that passed the eval | |
| scene_id | Yes | The scene to suggest graphics for (get_project lists them); its selected take needs a transcript | |
| project_id | Yes | From create_project | |
| estimate_only | No | Price it without spending; tell the person the price first |