Edit
AI-generatedSummary
Edit an existing image by applying a textual prompt to modify it using the specified model and optional parameters.
Inputs
- Model (required) — Select the editing model to use; currently only 'Nano Banana Edit' is available.
- Prompt (required) — Describes the desired changes or additions to the image.
- Image URL (required) — URL of the source image to be edited.
- Mask URL — Optional URL of a mask image to target specific areas for editing.
- Aspect Ratio (required) — Aspect ratio for the output image (e.g., 1:1, 16:9).
- Negative Prompt — Elements or features to avoid in the edited image.
- Seed — Random seed for the generation process; 0 generates randomly.
- Reply URL — Webhook URL to notify when editing task completes.
- Reply Ref — Custom reference string sent back in the webhook notification.
- Captcha Token — reCAPTCHA token if required by the Kie.ai API.
- Wait for Completion — Whether to wait synchronously for the editing task to complete before returning (true by default).
Output shape
a list with one item per input item containing the API response data for the edit task
If 'Wait for Completion' is true, the node returns the final task result after polling the API; otherwise, it returns the initial task creation response containing a taskId.
Examples
Example 1: Edit image with a prompt
Model: Nano Banana Edit, Prompt: 'Add a hat to the person', Image URL: 'http://example.com/image.jpg', Aspect Ratio: 1:1, Wait for Completion: true