AI Clipper: render chosen clips (async)
generate_clipsAI Clipper step 2/2: render the chosen candidates of a ready plan as 9:16 clips with captions. Costs 2 credits per clip (refunded per clip on failure). Returns project ids immediately — then wait_for_project / get_project for each.
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": {
"plan_id": "<plan_id>",
"candidate_ids": "<candidate_ids>"
},
"name": "generate_clips"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| plan_id | Yes | Plan id from start_clipper. | |
| candidate_ids | Yes | Candidate ids from get_clip_plan. | |
| caption_style | No | Override the plan's caption style. | |
| idempotency_key | No | Optional unique key (e.g. a uuid) — repeating the same call with the same key within 24 h returns the first result instead of charging again. |