ByteDance Doubao Seedream 5.0 Pro flagship image API via the official Volcano Ark channel. Highlights: interactive editing (mark exactly what to change with coordinates / box-select / arrows / hand-drawn marks — edits the region, keeps the rest), layer separation (split title text, copy, subject, background, decor), multilingual in-image text rendering (14+ languages) and multi-image fusion (up to 10 references). 1K/2K single-image output, no watermark.
All requests carry the API key in the header:
Authorization: Bearer YOUR_API_KEY| Field | Required | Type | Description |
|---|---|---|---|
| Resolution | Price / image | ||
| 1K | $0.076 | ||
| 2K | $0.15 |
Billed per successfully generated image (single image per call); failed requests are not charged. No image series or 4K.
/api/v1/images/generationsAsync contract: create returns a taskId; poll GET ?task_id= until completed, or receive a webhook via callback_url.
# Text-to-image — create returns a taskId, then poll for the result.
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5-0-pro",
"prompt": "a travel magazine cover, bold title \"SEEDREAM\", subtitle \"EXPLORE THE WILD\", a scarlet macaw in a sunlit rainforest, cinematic",
"resolution": "2K",
"output_format": "jpeg"
}'
# → { "code": 200, "data": { "taskId": "...", "state": "pending", "model": "doubao-seedream-5-0-pro" } }
curl "https://api.apimodels.app/v1/images/generations?task_id=TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
# → { "code": 200, "data": { "state": "completed", "resultUrls": ["https://r2.apimodels.app/..."] } }Same endpoint: include image (single) or images[] (up to 10) to run image-to-image / editing / multi-image fusion. Interactive editing and layer separation are driven by the prompt (mark the edit region on the reference with coordinates / box-select / arrows / hand-drawn marks).
# Image editing / multi-image fusion — pass one or more reference images.
# Interactive editing (coordinates / box / arrows / hand-drawn marks) and layer
# separation are driven by the PROMPT on the reference image.
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5-0-pro",
"prompt": "combine the product from image 1 with the scene in image 2, clean magazine layout",
"images": ["https://example.com/product.png", "https://example.com/scene.jpg"],
"resolution": "2K"
}'
# Single-image edit — one reference + an instruction
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5-0-pro",
"prompt": "keep the composition; add a ceramic coffee cup in the lower-right, make it blend naturally",
"image": "https://example.com/desk.jpg",
"resolution": "2K"
}'| Field | Required | Type | Description |
|---|---|---|---|
| Field | Type | Description | |
| model | string | doubao-seedream-5-0-pro | |
| prompt | string | Prompt (required); editing instructions and layer / coordinate marks go here | |
| resolution | string | 1K or 2K (default 2K) | |
| image / image_url / image_base64 | string | Single reference image → image-to-image / edit | |
| images | string[] | Multiple references, up to 10 (URL or data URI) | |
| output_format | string | jpeg (default) or png | |
| callback_url | string | Webhook URL called when the task completes |
Try it in the Playground
Pro adds interactive editing (mark the exact region to change via coordinates / box-select / arrows / hand-drawn marks), layer separation, and stronger multilingual in-image text rendering. It outputs a single 1K or 2K image (no series, no 4K).
$0.076 per image at 1K and $0.15 at 2K, billed only on success. One API key on apimodels.app, cheaper than going direct.
Up to 10 references for multi-image fusion / editing — pass them as images[] (or a single image). Image-to-image whose output still carries a real person is rejected by content review.