Create a compilation (async)
create_compilationCombine 2–30 finished projects (status complete) into one numbered long video — e.g. "Top 10 golden buzzers" (3+ min is a long-format video; whether Facebook runs ads in it is Meta's call). Costs 8 credits. Returns the project id immediately — then wait_for_project.
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_ids": "<project_ids>",
"title": "<title>"
},
"name": "create_compilation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| music | No | "none" (default) or a Brand Kit music id (list_brand_assets). | |
| title | Yes | Compilation title (also shown on the intro card). | |
| format | No | vertical 9:16 (default) or horizontal 16:9. | |
| language | No | Language of cards (default: the account's preference or en). | |
| numbering | No | Number badges: countdown (#10 → #1, default), countup, none. | |
| intro_card | No | Title card at the start (default true). | |
| outro_text | No | Closing text. | |
| project_ids | Yes | Finished project ids, in playback order. | |
| 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. |