Create Seedream image
最近更新：2026年10月21日
按火山方舟原生形状同步出图。支持图生图与图层拆分，计费按张 × 档位。
火山方舟 v3 原生格式的同步出图端点，请求与响应与官方 /api/v3/images/generations 一致。
已有火山方舟代码时，将 base_url 指向本站即可使用。
https://gateway.amux.ai/api/v3/images/generations鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> 控制台创建的 Amux 密钥。忘了可以回控制台的密钥页再看一次。
请求
application/jsonmodelstring必填站内模型 ID，可带 :供应商 后缀锁定供应商。
promptstring提示词。图层拆分（layer_decomposition: true）时可选，
由模型自动识别主体 / 文字 / 背景；其余场景必填。
imagestring | array<string>参考图，可选——不给就是文生图，给了就是图生图。一张发字符串，
多张发字符串数组，最多 10 张，单张 ≤ 30MB。
每一项是 https 地址或 data:image/<格式>;base64,…。地址必须公网可达，
指向内网或使用 http 时返回 400。
sizestring出图尺寸。生成场景收档位 1K / 1.5K / 2K（默认 2K，没有 4K），
也收像素串 宽x高（总像素约 92 万–462 万，原样转发）。
图层拆分只收 1K / 1.5K / 2K / auto（默认 auto），不收像素串。
计费按每张成片的实际像素归档：≤ 170 万像素算 1K，≤ 261 万算 1.5K，
其余算 2K。提交时按上界预扣，完成后按实际结算、退还差额。
output_format"jpeg" | "png"默认 "jpeg"输出编码。图层拆分时只管底图，图层恒为 png。
background"opaque" | "transparent"默认 "opaque"transparent 出透明底 png。只用于图生图，要求恰好 1 张带透明通道的
输入图，且不能与 output_format: jpeg 同用，违反任一条件时返回 400。
watermarkboolean默认 false右下角「AI 生成」水印。上游默认开启，本站默认关闭，传 true 时开启。
layer_decompositionboolean默认 false图层拆分：把一张图拆成底图 + 若干图层。**目前只有 bytedance/seedream-5.0-pro
与 bytedance/seedream-5.0-flash 支持。要求 image 恰好 1 张**
（png / jpeg，建议 ≥ 512×512）。底图与每个图层都按张计费，
单张最多拆出 16 个图层，预扣按 17 张冻结。
optimize_prompt_optionsobject提示词优化配置。不传就是官方默认的 standard。
›optimize_prompt_optionsobject
mode"standard" | "fast"默认 "standard"standard 质量更高、耗时更长；fast 更快、效果略低，只有 5.0 pro 支持
（flash 传 fast 返回 400）。两档同价。
response_format"url" | "b64_json"默认 "url"返回形式。b64_json 时 data[] 里回图片的 base64、不回 url，与官方一致；
两种形式的产物均存入本站存储，可在日志与操练场中查看。
响应
200response出图完成。
400response参数不合法：图层拆分给了 0 张或多张图、拆分时 size 用了像素串、
参考图超过 10 张、透明底的前提不满足、image 地址不可用。
402response可用余额不足以覆盖这次的预扣。
502response上游出图失败。不收钱，预扣已经退回。
支持的模型
| 模型 | 尺寸 | 参考图 | 图层拆分 | 提示词优化 | 计价 |
|---|---|---|---|---|---|
bytedance/seedream-5.0-pro | 1K / 1.5K / 2K 或 宽x高 | 最多 10 张 | 支持 | standard / fast | 按张，分两档 |
bytedance/seedream-5.0-flash | 1K / 1.5K / 2K 或 宽x高 | 最多 10 张 | 支持 | 仅 standard | 按张，单一价格 |
各模型的完整参数与示例见模型文档：seedream-5.0-pro、 seedream-5.0-flash。
与 /v1/images/generations 的区别
两个端点均可调用上述模型，size、watermark、layer_decomposition、optimize_prompt_options
等火山方舟参数在两者上均原样生效，区别仅在请求与响应格式：
/v1/images/generations | 本端点 | |
|---|---|---|
| 请求与响应格式 | OpenAI | 火山方舟 |
响应中的 model | 站内模型 ID | 上游模型 ID |
amux 字段 | 有（含费用与任务 ID） | 无 |
| 适用场景 | OpenAI 生态客户端 | 火山方舟 SDK |
水印
火山方舟默认在右下角添加「AI 生成」水印。本站默认关闭水印，传 watermark: true 时开启。
参数约束
以下情况在提交时返回 400，不会建立任务或预扣：
- 图层拆分（
layer_decomposition: true）未传或传入多张image，或size使用了像素值； - 参考图超过 10 张；
background: "transparent"时image不是恰好 1 张，或同时指定了output_format: "jpeg"。
图层拆分的响应
data 中第一项为底图（z_index: 0），其后每个图层一项，z_index 从 1 递增：
{
"data": [
{ "url": "https://…/task_x-0.jpg", "size": "800x1424", "output_format": "jpeg", "z_index": 0 },
{
"url": "https://…/task_x-1.png",
"size": "799x613",
"output_format": "png",
"z_index": 1,
"bounding_box": { "absolute": [222, 638, 684, 993], "normalized": [278, 448, 854, 697] },
"name": "咖啡杯",
"description": "盛有浓缩咖啡的白色陶瓷咖啡杯"
}
],
"usage": { "generated_images": 2, "input_images": 1 }
}- 底图格式随
output_format，图层恒为带透明通道的 png； bounding_box.normalized为 0–1000 的整数，还原到底图时建议使用absolute；- 底图与每个图层分别计费，
usage.generated_images即计费张数。
返回形式
response_format 默认 url，返回本站存储地址；设为 b64_json 时仅返回 base64，不返回 url。
两种形式的产物均会存入本站存储。
计费
按张计费，不按 token。flash 各档位同价；pro 按每张成片的实际像素分两档：
| 实际像素 | 档位 |
|---|---|
| ≤ 261 万（1K、1.5K） | 低档 |
| > 261 万（2K） | 高档 |
提交时按上界预扣（图层拆分按 17 张），完成后按实际用量结算并退还差额；可用余额不足以覆盖 预扣时返回 402。失败不计费。
响应中的 output_tokens 与 total_tokens 为上游按面积折算的参考值，不参与计费。本端点的响应
不含费用字段，费用可在控制台日志中查看，或改用 /v1/tasks 提交并在取回结果中读取 cost。
curl https://gateway.amux.ai/api/v3/images/generations \
-H "Authorization: Bearer $AMUX_API_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro",
"prompt": "一只红色的纸船漂在雨后的街道上，电影感光影",
"size": "2K",
"watermark": false
}'{
"model": "doubao-seedream-5-0-pro-260628",
"created": 1792511123,
"data": [
{
"size": "2048x2048",
"url": "https://cdn.amux.ai/gen/20261021/task_01M5CWPZEAJ6FRGPDM1G7G1V29-0.jpg",
"output_format": "jpeg"
}
],
"usage": {
"generated_images": 1,
"output_tokens": 16384,
"total_tokens": 16384
}
}