prompt | string | yes | - | Text prompt. With image attached, becomes an editing or fusion instruction. |
image | array | no | - | Reference image URL, data URI, or uploaded image object. Seedream 5.0 Pro supports up to 10 reference images. |
images | array | no | - | Alias for image. Use this for multiple uploaded image references. |
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" | Seedream Pro resolution tier. Defaults to 2K. · Allowed: 1K, 2K |
size | string | no | - | Resolution tier or explicit pixel size such as 1K, 2K, or 2048x2048. Explicit pixels override aspect_ratio and quality. |
use_custom_size | boolean | no | false | Use custom_width and custom_height instead of preset aspect_ratio and quality. |
custom_width | number | no | - | Custom output width in pixels. Total area must be in [0.92MP, 4.19MP], aspect must be in [1:16, 16:1], and dimensions must be multiples of 16. · Range: 16 – 8192 |
custom_height | number | no | - | Custom output height in pixels. Total area must be in [0.92MP, 4.19MP], aspect must be in [1:16, 16:1], and dimensions must be multiples of 16. · Range: 16 – 8192 |
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 |