Attach a clip to a scene
set_scene_clipDestructive
Attach existing footage to one scene: an owned ready clip generation, a verified video upload, or a finished storyboard render. Replaces the scene's clip and keeps its still; nothing is generated. One undo step; undo_storyboard takes it back. Spends no credits.
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": {
"storyboard_id": "<storyboard_id>",
"scene": "<scene>",
"reference": "<reference>"
},
"name": "set_scene_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scene | Yes | ||
| reference | Yes | An owned ready clip generation, verified video upload, or finished storyboard render. Attaches existing footage without generating anything; the scene keeps its still. | |
| storyboard_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cast | Yes | ||
| brief | Yes | ||
| notes | Yes | ||
| quote | No | ||
| texts | Yes | ||
| scenes | Yes | ||
| sounds | Yes | ||
| videos | Yes | ||
| credits | Yes | ||
| history | Yes | ||
| message | Yes | ||
| skipped | No | ||
| started | No | ||
| stopped | No | ||
| accepted | No | ||
| receipts | No | ||
| schedule | Yes | ||
| settings | Yes | ||
| reference | No | ||
| storyboard | Yes | ||
| download_url | No | ||
| generation_id | No | ||
| remaining_scenes | No |