Prepare connected video shots from a text group
playground_storyboard_prepareCreate ready-to-generate video shot nodes connected to text nodes inside a selected text group. This only prepares nodes; it does not submit paid video jobs. Requires the latest canvas revision. Returns shot node IDs, source node ID, optional stitch/group IDs and revision.
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>",
"sourceNodeId": "<sourceNodeId>",
"modelId": "<modelId>",
"aspectRatio": "<aspectRatio>",
"shots": "<shots>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "playground_storyboard_prepare"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shots | Yes | ||
| modelId | Yes | Canonical model ID returned by model discovery or resolution; preserve the user’s selected model. | |
| projectId | Yes | ID of the Playground project chosen for this task; obtain it from project creation, an explicit project link or current context. | |
| aspectRatio | Yes | Output width-to-height ratio supported by the selected model, such as 1:1 or 9:16. | |
| sourceNodeId | Yes | Existing canvas source node ID to use for this operation. | |
| 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 |
|---|---|---|---|
| groupId | No | ||
| replayed | Yes | ||
| revision | Yes | ||
| shotNodeIds | Yes | ||
| sourceNodeId | Yes | ||
| stitchNodeId | Yes |