ByteDance 豆包 Seedream 5.0 Pro 旗舰图片 API,走火山方舟官方通道。亮点:交互编辑(坐标 / 框选 / 箭头 / 手绘标记指定区域,只改该处、保留其余)、图层分离(拆分标题/文案/主体/背景/装饰)、多语言图内文字渲染(14+ 语言)、多图融合(最多 10 张参考图),1K/2K 单图输出、无水印。
所有请求在 Header 携带 API Key:
Authorization: Bearer YOUR_API_KEY| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| 分辨率 | 价格 / 张 | ||
| 1K | $0.076 | ||
| 2K | $0.15 |
按成功生成的图片张数计费(单图),失败不扣费。不支持组图 / 4K。
/api/v1/images/generations异步契约:创建返回 taskId,轮询 GET ?task_id= 到 completed 取结果,或用 callback_url 接 webhook。
# 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/..."] } }同一端点:带 image(单张)或 images[](最多 10 张)即走图生图 / 编辑 / 多图融合。交互编辑与图层分离通过 prompt 描述(在参考图上用坐标 / 框选 / 箭头 / 手绘标记指定编辑位置)。
# 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"
}'| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| 字段 | 类型 | 说明 | |
| model | string | doubao-seedream-5-0-pro | |
| prompt | string | 提示词(必填);编辑指令、图层/坐标标记说明都写在这里 | |
| resolution | string | 1K 或 2K(默认 2K) | |
| image / image_url / image_base64 | string | 单张参考图 → 图生图 / 编辑 | |
| images | string[] | 多张参考图,最多 10 张(URL 或 data URI) | |
| output_format | string | jpeg(默认)或 png | |
| callback_url | string | 任务完成后的 webhook 回调 URL |
试一试:Playground
Pro 多了交互编辑(用坐标/框选/箭头/手绘标记指定要改的区域)、图层分离、更强的多语言图内文字渲染。单图输出 1K 或 2K(无组图、无 4K)。
1K $0.076/张、2K $0.15/张,仅成功扣费。apimodels.app 一把 Key 即可调用,比官方直连便宜。
最多 10 张参考图(多图融合/编辑),用 images[] 传(或单张 image)。图生图产出若仍含真实人物会被内容审核拒绝。