Assemble Playground clips into one film
playground_media_composeStitch 2–12 finished video nodes, in the given order, into one film. Creates an "Assemble film" (video-stitch) node wired from the clips and queues the existing FFmpeg film worker, which normalizes the clips, concatenates them and attaches the MP4 to that node. Clips must be generated video nodes in this project's storage sharing one 16:9, 9:16 or 1:1 aspect ratio. Free: no credits are spent. Returns immediately; poll playground_run_delivery with the returned runId (every ≥30 s) until verified, or read the stitch node's generated URL with playground_node_get.
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": {
"projectId": "<projectId>",
"expectedRevision": "<expectedRevision>",
"idempotencyKey": "<idempotencyKey>",
"videoNodeIds": "<videoNodeIds>"
},
"name": "playground_media_compose"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Human-readable label to display for this item in Playground. | |
| projectId | Yes | ID of the Playground project chosen for this task; obtain it from project creation, an explicit project link or current context. | |
| videoNodeIds | Yes | Source video node IDs in the order they should appear in the assembled video. | |
| idempotencyKey | Yes | Unique key for this request; reuse only when retrying the identical request after a lost response. Use a new key after quoting or changing inputs. | |
| expectedRevision | Yes | Current canvas revision from canvas_read; on revision_conflict, read again and rebuild the change. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| poll | Yes | ||
| error | No | ||
| runId | Yes | ||
| status | Yes | ||
| replayed | Yes | ||
| revision | Yes | ||
| canvasUrl | Yes | ||
| onFailure | Yes | ||
| shotNodeIds | Yes | ||
| stitchNodeId | Yes | ||
| conversationId | Yes | ||
| retry_after_seconds | Yes |