Parameters
A description of the desired image. Be specific, precise, and detailed. Use advanced AI image generation prompting techniques to produce visually compelling results.
The base name for the output files (e.g., “myimg” will create “myimg_1.png”, “myimg_2.png”, etc.).
The number of images to generate (between 1 and 10). Defaults to 1.
The directory where the generated images will be saved. Defaults to /home/workspace/Images.
The desired image aspect ratio, e.g. “16:9”, “1:1”, “3:4”.
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 prompt adherence 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.