shot.create
Add a shot to a scene with camera direction (§38). Each shot gets its own video clip on the timeline; the scene's length becomes the sum of its shots and later clips ripple. The first shot of a scene takes over the scene's existing video placeholder.
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>",
"expectedVersion": "<expectedVersion>",
"sceneId": "<sceneId>"
},
"name": "shot.create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | ||
| order | No | Position within the scene (default: last) | |
| action | No | What happens during the shot (used for video) | |
| camera | No | Physical camera settings. Unset fields are left to the model. | |
| sceneId | Yes | ||
| dialogue | No | Spoken line(s); prefix with the speaker's name ("ANNA: …") so shot.lipsync knows who says it | |
| lighting | No | ||
| shotSize | No | ||
| projectId | Yes | ||
| locationId | No | Override the scene's location for this shot (null = where the scene is) | |
| videoModel | No | ||
| aspectRatio | No | This shot's frame shape (null = the film look's, else the project's). Stills use it; the video take follows its start frame | |
| cameraAngle | No | ||
| composition | No | e.g. "rule of thirds, subject frame left, negative space right" | |
| description | No | What the frame shows | |
| characterIds | No | Cast members in frame — their reference images keep them consistent | |
| generateAudio | No | Ask the video model for native audio (costs more) | |
| cameraMovement | No | ||
| expectedVersion | Yes | ||
| videoResolution | No | Video output resolution (null = the model's default; only some models offer a choice, and higher costs more) | |
| plannedDurationMs | No | ||
| speakerCharacterId | No | Who speaks the dialogue (null = the character it names, else the first cast member with a voice) |