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