edit_image
Edit an existing image using AI. For the selected image of an existing shot use regenerate_shot_image. For a standalone image, provide the media ID and a text prompt describing what to change. Creates a new version and preserves the original. Uses Nano Banana 2.1 (google-nano-banana-2-1).
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>",
"mediaId": "<mediaId>",
"editPrompt": "<editPrompt>"
},
"name": "edit_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Image edit model ID. Uses the default if omitted. | |
| mediaId | Yes | Media ID of the existing image to edit | |
| editPrompt | Yes | Instructions for what to change in the image (e.g., "make the sky more orange", "add a hat to the character") | |
| workspaceId | Yes | The workspace ID |