Generate a single composed illustration from a prompt - a scene, environment, hero image, banner, character portrait, or any standalone picture. (For a SET of separate isolated subjects sharing one style - icons, sprites, asset packs - use generate_image_set for solid-color backgrounds, or generate_transparent_image_set for transparent backgrounds, instead.) Returns a zip download URL: the image plus a prompt.json recording what you asked for, plus an index.html viewer. Each call costs 1 credit. Run generation calls sequentially, never in parallel - only one generation runs at a time per API key.
The prompt describes the picture and is used as written (no template, no appended instructions); do not put the pixel size in it - put the size in the width and height arguments. width and height must be one of the supported pixel pairs below; any other pair is rejected. These are the maximums offered - nothing larger is available. Each line is one shape: the first pair is that shape's largest size, the rest are exact proportional downscales of it.
2816x1584, 1408x792, 704x396
2048x2048, 1024x1024, 512x512, 256x256
1456x2912, 728x1456, 364x728
3200x1440, 1600x720, 800x360
2912x1456, 1456x728, 728x364
1664x2496, 832x1248, 416x624
2496x1664, 1248x832, 624x416
1776x2368, 888x1184, 444x592
2368x1776, 1184x888, 592x444
1584x2816, 792x1408, 396x704
1440x3200, 720x1600, 360x800
Formats: png (default, lossless), jpg, webp. quality (1-100) applies to jpg and webp; default 90.
Prompt max length: 2500 characters. A prompt that does not describe a picture is rejected.
unpackTo: a directory on your local filesystem to extract the downloaded zip into. filename: name for the image file inside the zip (default illustration.<ext>).
If a "Rate limit exceeded" error is returned, wait the suggested number of seconds before retrying. Do not retry immediately.