Render a promo's finals
render_promoRenders the promo's final in the sizes you choose (9:16, 1:1, 4:5, 16:9) at 1080p, then checks each file. Each size is priced per scene (3 credits per started 2 s) plus 10 to put it together; the 9:16 draft is already its final, at no charge, if nothing changed since. Show the person each size's price (estimate_only) and let them choose. The balance must cover every size asked for, or nothing starts. It answers as soon as the renders start, with poll: call get_promo as it says until stage is done (about two minutes). review_render works on each final's render_id.
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": {
"promo_id": "<promo_id>"
},
"name": "render_promo"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sizes | No | The sizes to render (the promo's chosen sizes by default) | |
| promo_id | Yes | The promo's id | |
| wait_seconds | No | How long to wait for the finals (0 by default: it answers as soon as they start; the call never runs past about 45 s) | |
| estimate_only | No | Give each size's price and spend nothing |