Seedream 5.0 Pro

模型 ID：doubao-seedream-5-0-pro-260628。文生图、图生图和图层分离统一使用 POST https://apimaster.ai/v1/images/generations，JSON 请求，Bearer API Key 认证。

支持同步生成单图、最多 10 张参考图、图层分离、透明图层再编辑。不支持流式输出、组图生成、联网搜索。不要发送 stream: true、sequential_image_generation 或 tools；不要使用 /images/generations/async。长任务请设置至少 300 秒的客户端超时，避免因客户端提前断开而重复生成。

基础价格

以下为基础价格（USD），实际账户价格叠加渠道与用户分组系数，以模型广场和账单为准。

计费项目	每张实际输出 ≤ 2,610,000 像素	每张实际输出 > 2,610,000 像素
图片生成（文生图 / 图生图）	$0.045	$0.09
图层分离（底图与各图层）	$0.0225	$0.045

输入参考图 $0.003/张，每次请求首张免费。两张参考图收取一张输入图费用；十张参考图收取九张。

计费依据响应中每张图片的 data[].size 宽×高，分别判断档位，然后相加。图层分离包含底图，不能只按请求的 size 给所有图层统一套价。2048x1024 虽然长边为 2048，但只有 2,097,152 像素，属于低价档。

例如：一张高分辨率底图 + 三张低分辨率图层，基础费用为 $0.045 + 3 × $0.0225 = $0.1125；单张输入图免费。

文生图

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "奶油色背景的极简海报：左侧红色圆形，右侧蓝色方形，上方黑色标题 SEEDREAM TEST",
    "size": "1.5K",
    "output_format": "png",
    "watermark": false
  }'

size 支持 1K、1.5K、2K，图片生成默认 2K。1.5K 与 1K 同基础价，最终宽高由提示词中的构图要求决定。

也可指定 宽x高，例如 2048x1024。像素总数须在 921,600–4,624,220 之间，宽高比在 1:16–16:1 之间。512x512 不合法。档位参数与精确尺寸二选一，不使用其他图片模型的 resolution 参数。

图生图与多图参考

仍调用 /images/generations，使用字段 image，支持 URL 字符串、URL 数组或 data:image/png;base64,...。不要把本地文件路径直接填到 image。

{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "只把红色圆形改为绿色，保留蓝色方形、文字和布局",
  "image": "https://your-public-host.example/source.png",
  "size": "1.5K",
  "output_format": "png",
  "watermark": false
}

多图参考将 image 改为 ["https://.../first.png", "https://.../second.png"]，最多 10 张，仍只生成一张。每张输入图最大 30 MB、最大 3600 万像素，宽高比 1:16–16:1，宽高均大于 14 像素；支持 JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF。

图层分离

设置 layer_decomposition: true，必须提供且只能提供一张 PNG/JPEG 图片。输入图像素范围为 262,144–36,000,000，最大 30 MB，宽高比 1:16–16:1。

{
  "model": "doubao-seedream-5-0-pro-260628",
  "image": "https://your-public-host.example/poster.png",
  "layer_decomposition": true,
  "size": "auto",
  "output_format": "png",
  "watermark": false
}

• prompt 可省略，自动识别主要元素；也可填写“把标题、圆形和方形拆成独立图层”。
• size 仅支持 1K、1.5K、2K、auto，默认 auto；这里不支持 2048x1024 等精确尺寸。
• 返回 1 张底图 + 最多 16 个图层。图层始终为透明 PNG，output_format 仅控制底图。
• 任一图层生成失败时，上游整体报错，不返回部分成功。

响应结构示意（下载地址为占位符）：

{
  "model": "doubao-seedream-5-0-pro-260628",
  "data": [
    {"url": "https://.../base.png", "size": "1248x832", "output_format": "png", "z_index": 0},
    {
      "url": "https://.../square.png", "size": "718x681", "output_format": "png",
      "z_index": 1, "name": "蓝色实心正方形", "description": "独立方形图层",
      "bounding_box": {"absolute": [682,343,1048,689], "normalized": [546,412,839,827]}
    }
  ],
  "usage": {"input_images": 1, "generated_images": 2}
}

z_index: 0 为底图，其余按 z_index 从小到大叠放。bounding_box.absolute 是底图坐标系中的 [x_min,y_min,x_max,y_max]：把图层缩放到 x_max-x_min × y_max-y_min 后，放在 (x_min,y_min)。normalized 使用 0–1000 坐标，乘以目标画布宽高再除以 1000 即可。图层原始像素尺寸不等于其在底图上的占位尺寸。

保持透明背景再编辑

把分离得到的单个透明 PNG 图层作为 image，填写编辑指令，并设置 background: "transparent"、output_format: "png"。此模式仅支持单张带透明通道的参考图，不支持 JPEG 输出。

返回格式与错误处理

response_format 默认为 url，也支持 b64_json；相应读取 data[].url 或 data[].b64_json。应遍历完整的 data，保留尺寸、图层顺序和边界框，不要只保存第一张图。

上游 URL 有效期为 24 小时，请及时下载保存，不应把返回地址当作永久资源。usage.generated_images 为成功输出数量，usage.input_images 为输入图片数量；图片按张和像素档位计费，不按响应中的 output_tokens 计费。

HTTP 400 通常表示参数不合法，例如图层分离传入多张图片、生成尺寸过小。修正参数后重试，不要循环重试相同的错误请求。

验证范围

已实测文生图 1K / 1.5K / 2K / 2048x1024、URL 与 Base64 图生图、双图参考、1K / 2K / auto 图层分离及非法尺寸/多图拆分错误。图层测试返回了底图、方形、圆形、标题四个独立结果，包含叠放顺序与边界框。

参考：火山方舟图片生成 API。本文按 APIMaster 接口与实测结果整理；费用采用平台配置的基础价格。