prompt | string | yes | - | Text prompt. With image attached, becomes an editing instruction. For batch mode, describe each image sequentially. |
aspect_ratio | enum | no | "auto" | Auto lets the model choose dimensions within the selected resolution tier. Explicit ratios use the preset size for that tier. · Allowed: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 |
quality | enum | no | "2K" | 2K is about 4MP. 3K is about 9MP. · Allowed: 2K, 3K |
use_custom_size | boolean | no | false | Use custom_width and custom_height instead of preset aspect_ratio and quality. |
custom_width | number | no | - | Pixels. Total area must be in [2.56MP, 10.4MP]; aspect must be in [1:16, 16:1]. Only when use_custom_size=true. · Range: 1024 – 4704 |
custom_height | number | no | - | Pixels. Total area must be in [2.56MP, 10.4MP]; aspect must be in [1:16, 16:1]. Only when use_custom_size=true. · Range: 1024 – 4704 |
image | array | no | - | Up to 14 reference image URLs for editing. Triggers image-edit mode. |
images | array | no | - | Alias for image. Use this for multiple uploaded image references. |
batch_enabled | boolean | no | false | Generate a cohesive set of related images from a single prompt. |
max_images | number | no | 4 | Batch mode only. Maximum images in the set; the model decides actual count. You’re billed only for images returned. · Range: 1 – 15 |
watermark | boolean | no | false | When enabled, the generated image includes an AI-generated provenance watermark. EmpirioLabs does not add a separate watermark. |
output_format | enum | no | "png" | Output image file format. · Allowed: jpeg, png |
response_format | enum | no | "url" | Return signed image URLs by default, or include base64 image data when b64_json is requested. · Allowed: url, b64_json |