Insert a new scene into a video
insert_sceneInsert a newly generated 5-13 second scene into an existing clip at any point, then resume the original footage without re-rendering the rest. Use it for product close-ups, reactions, or reveals mid-ad.
Instructions
INSERT a newly generated scene into a clip you already have: the video plays up to startTime, the new scene (5 to 13 seconds) plays, then the original picks up again at resumeTime. Use for a product close-up, a reaction, a reveal or a missing beat in the middle of an ad without re-rendering the rest. resumeTime = startTime keeps every second of the original; a later resumeTime also cuts the footage in between. Describe the scene in prompt and/or attach up to 4 reference pictures (refImages) or 1 reference clip (refVideos). Clips up to 60 seconds; both times between 1.625 and 60 seconds. Paid render (billed per second of NEW scene); returns the whole video's URL.
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": {
"video": "<video>",
"startTime": "<startTime>",
"resumeTime": "<resumeTime>"
},
"name": "insert_scene"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| video | Yes | the source video URL (a render, job result or list_library item) | |
| prompt | No | what happens in the new scene: the action, the subject, the camera | |
| seconds | No | length of the new scene, 5-13 seconds (default 5) | |
| get_cost | No | true: return the price only; nothing runs or bills | |
| refImages | No | up to 4 picture URLs of what should appear (the product, a person, a place) | |
| refVideos | No | up to 1 clip URL whose look or motion the scene follows | |
| startTime | Yes | seconds into the clip where the new scene starts (1.625-60) | |
| resolution | No | default 720p (rendered at 768p); '480p' is cheaper | |
| resumeTime | Yes | seconds into the ORIGINAL clip where it picks up again after the new scene (2.625-60, at or after startTime) | |
| idempotency_key | No | chosen once, resent unchanged on retries: the same key never buys twice | |
| expected_credits | No | the get_cost price; refused unbilled if the live price differs |