generate_shot_video
Generate a video from one existing shot still and attach it to that shot. Use approved settings, maxCostUsd and a stable idempotencyKey. Retries reuse the original generation and attachment without overwriting subsequent timeline edits. Keep the result inside the edit.
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": {
"workspaceId": "<workspaceId>",
"editId": "<editId>",
"shotId": "<shotId>"
},
"name": "generate_shot_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Video model ID. Uses the edit default when omitted. | |
| editId | Yes | The edit ID | |
| prompt | No | Motion prompt. Defaults to the shot videoPrompt when omitted. | |
| shotId | Yes | The shot that should receive the generated video | |
| volume | No | Attached shot-video volume. Keep 0 when narration or a separate mix owns the audio. | |
| duration | No | Generated source duration in seconds, chosen independently of the final trimmed timeline duration. Use supported model settings and set source trims with update_shot. | |
| approvalId | No | Combined production approval ID returned by set_proposal_status. | |
| maxCostUsd | No | Maximum charge for each output. Checked against authoritative pricing before generation. | |
| resolution | No | Output resolution supported by the selected model, for example 720p or 1080p. | |
| aspectRatio | No | Aspect ratio. Uses the edit default when omitted. | |
| workspaceId | Yes | The workspace ID | |
| approvalJobId | No | Exact production jobId covered by that combined approval. | |
| modelSettings | No | Model-specific controls using keys and options from get_model_catalog inputConstraints.slots or variantSelector. | |
| idempotencyKey | No | Stable request key. Retries with the same key reuse the existing output and do not start another paid generation. | |
| deferAttachment | No | Keep the current shot video until this replacement completes. |