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 long-form qualifies for in-stream ads on Facebook). Costs 8 credits. Returns the project id immediately — then wait_for_project.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| music | No | "none" (default) or a Brand Kit music asset id. | |
| 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. |