Parameters
A description of the desired image. Be specific, precise, and detailed about the desired modifications to the existing image. Use advanced AI image generation prompting techniques to produce visually compelling results.
List of 1 to 3 absolute paths to images to be edited or combined. Edited image will be saved in the same directory as the first input image with the specified suffix. For optimal subject consistency, provide multiple reference images showing different angles/views of the subject.
The suffix to append to the output file (e.g., “_edited” will create “image_edited.png”). Defaults to “_edited” if not specified.
Which model to use. Defaults to "" (empty), which routes through the user’s configured default image provider in AI settings. Pass “google” (Nano Banana — fast and cheap) or “openai” (GPT Image 2 — ~3× more expensive but better edit fidelity and legible rendered text) to override on this call only; use the override when the user explicitly asks for a specific provider or a level of quality only one of them satisfies.