edit_image
Edit an existing image by sending a text instruction, such as changing the background or adding an object. Returns the file path to the edited image.
Instructions
Edit an existing image using a text instruction (e.g. "make the background blue", "add a red hat"). Uses fal or OpenAI. Requires the matching provider key. Returns the path to the edited image.
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_path": "<image_path>",
"prompt": "<prompt>"
},
"name": "edit_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Model id. Omit for the default (fal: qwen-image-edit, openai: gpt-image-1). | |
| prompt | Yes | The editing instruction | |
| provider | No | AI provider. Omit to use the first configured key. | |
| image_path | Yes | Local path to the image to edit |