edit_image
Edit a single image globally with a text command like 'add a hat' or 'change colors'. Apply prompt-based changes across the entire image, not just a region.
Instructions
Edit a single image globally using a text description (e.g. 'add a hat', 'change colors'). 16-400px. For editing a specific REGION use inpaint_v3 with a mask instead. For batch-editing multiple images at once use edit_images.
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": {
"image": "<image>",
"image_size": "<image_size>",
"description": "<description>",
"width": "<width>",
"height": "<height>"
},
"name": "edit_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Seed for deterministic generation (default 0) | |
| image | Yes | Image to edit | |
| width | Yes | Target canvas width (16-400px) | |
| height | Yes | Target canvas height (16-400px) | |
| image_size | Yes | Current image dimensions | |
| color_image | No | Color reference image | |
| description | Yes | Edit description | |
| no_background | No | Generate with transparent background | |
| text_guidance_scale | No | How closely to follow text (1.0-10.0, default 8) |