Can I use the abbreviated name Seedream 5.0 Pro when making calls?
You should pass the full model to POST /seedream/images: doubao-seedream-5-0-pro-260628. Standard generation and editing also require prompt, and assets are submitted through image when editing. Using the full string explicitly selects this version; do not replace the invocation ID with a display name or abbreviation.
Will multiple reference images produce a set of images?
No. Standard generation and editing can accept up to 10 reference images, but the output is still a single image. Reference images are used to guide the subject, style, or composition, and do not represent the number of outputs. To obtain a related image set, choose a Seedream version that supports sequential_image_generation.
How do I set landscape, portrait, and resolution?
For standard generation, you can set size to 1K, 1.5K, or 2K, and describe landscape, portrait, or the target aspect ratio in prompt; you can also use WIDTHxHEIGHT to specify pixel dimensions that meet the requirements. auto is used for layer decomposition and should not be used as a size option for standard Pro generation.
Is a prompt required for layer decomposition?
No. Submit a PNG/JPEG and set layer_decomposition to true for automatic decomposition; add prompt only when you need to focus on specific elements. The result includes a base image, transparent layers, and position information, which can be stacked from bottom to top according to z_index, but this is not equivalent to project files such as PSD.
How can I retrieve generation results without keeping the connection open?
You can set async to true, obtain task_id first, then query the final result through /seedream/tasks; you can also set callback_url to receive completion notifications. Applications should save the task ID to associate requests with images, then read image_url or b64_json after obtaining the result. Do not treat task creation as generation completion.