regenerate_shot_image
Regenerate the starting image of an existing shot as the next version. Keeps the same shot and image media IDs, preserves previous versions, and selects the new image in the shot on success. Use this for a shot retake or revised shot image. May spend Sequencer 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": {
"workspaceId": "<workspaceId>",
"editId": "<editId>",
"shotId": "<shotId>"
},
"name": "regenerate_shot_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Image model ID. Defaults to the selected start frame model, then project settings. | |
| editId | Yes | The edit ID | |
| prompt | No | Full image generation prompt. Omit to reuse the selected start frame prompt. | |
| shotId | Yes | The existing shot that receives the image version | |
| maxCostUsd | No | Maximum charge for each output. Checked against authoritative pricing before generation. | |
| resolution | No | Output resolution from the selected model catalog. | |
| aspectRatio | No | ||
| mediaInputs | No | Named media slots from get_model_catalog, for example reference_image_uri or mask_url. | |
| workspaceId | Yes | The workspace ID | |
| modelVariant | No | Variant value from get_model_catalog variantSelector.options, such as high for Flare quality. Uses the catalog default when omitted. | |
| 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. | |
| negativePrompt | No | ||
| sourceImageUrl | No | Public HTTP(S) source image/start-frame URL. Use mediaId for workspace images. | |
| expectedMediaId | No | Current shot image ID from get_shot. A changed attachment prevents generation. | |
| referenceImages | No | Images to guide generation. Use labels such as person or product and refer to them as @person or @product in the prompt. Each item accepts a workspace mediaId or a public HTTP(S) URL. | |
| sourceImageMediaId | No | Workspace image to use as the source image/start frame. | |
| expectedVersionNumber | No | Current selected start frame version from get_shot. A changed selection prevents generation. |