Seedream 5.5

模型 ID：doubao-seedream-5-5-261028。统一使用 POST https://apimaster.ai/v1/images/generations，JSON 请求，Authorization: Bearer YOUR_API_KEY。请在控制台创建 APIMaster API Key。

支持文生图、最多 10 张参考图生图、连续编辑、原生 RGBA 透明图片，以及图层拆分与规整文字 OCR。普通生成一次输出一张图；图层拆分输出一张底图及多个图层。不支持流式输出、组图生成、联网搜索，不要套用其他模型的 stream: true、sequential_image_generation、tools 或异步生成接口。

价格与结算

按 2026-11-13 核查的火山方舟官方价格设置基础价格：

项目	官方人民币单价	基础 USD 单价（本次配置汇率 7）
每张输入参考图，包含第一张	¥0.05	约 $0.00714286
每张输出图，宽×高 ≤ 2,610,000 像素	¥0.13	约 $0.01857143
每张输出图，宽×高 > 2,610,000 像素	¥0.23	约 $0.03285714

普通生图与图层拆分采用同一输出单价；拆分的底图和每个图层都分别计费。按响应中每张 data[].size 的像素乘积判断档位，不按长边或请求中的 size 统一收费。2048x1024 为 2,097,152 像素，仍是低价档。失败且未产出图片不按成功图片收费。

例如：两张参考图生成一张 2K 高价档图片，基础价格为 2 × ¥0.05 + ¥0.23 = ¥0.33。一张参考图拆成一张高价档底图、三张低价档图层，基础价为 ¥0.05 + ¥0.23 + 3 × ¥0.13 = ¥0.67。5.5 首张参考图收费，不适用 5.0 Pro 的首张免费规则。

上述为基础价；账户实际扣费还取决于渠道及用户分组系数，并以整数 quota 结算。模型广场显示当前路由价格，后台日志记录实际输入张数、输出张数、计费档位和扣费明细。

快速开始：文生图

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-5-261028",
    "prompt": "设计一张横版海报，奶油色背景，红色圆形与蓝色方形，标题为 HELLO SEEDREAM",
    "size": "1.5K",
    "output_format": "png",
    "background": "opaque",
    "response_format": "url",
    "watermark": false
  }'

同步等待图片返回。建议客户端超时至少 300 秒；不要在超时后盲目重复提交，否则可能产生重复任务与费用。

请求参数

字段	类型 / 默认值	使用规则
model	string，必填	固定使用 doubao-seedream-5-5-261028。
prompt	string	图片生成必填；图层拆分可省略，省略时自动规划主要元素。可描述内容、画风、比例、文字或局部编辑位置。官方建议中文不超过 300 字、英文不超过 600 词，这是创作建议，不是字节长度上限。
image	string 或 string[]，可选	参考图的公网 URL 或 data:image/png;base64,...；普通生图最多 10 张；图层拆分仅一张。不要传本地文件路径。
size	string	普通生成默认 2K，可用 1K、1.5K、2K 或 宽x高；拆分默认 auto，仅可用档位及 auto。详见尺寸规则。
output_format	string，默认 png	png 或 jpeg；拆分时只控制底图，图层始终为 PNG。
background	string，默认 auto	普通生成可用 auto、transparent、opaque。transparent 必须搭配 png；拆分时不要传此参数。
response_format	string，默认 url	url 返回下载地址；b64_json 返回 Base64 图像数据。
watermark	boolean，默认 true	false 不添加可见水印；true 添加“AI 生成”水印。
optimize_prompt_options	object，可选	{"mode":"standard"}；5.5 仅支持 standard，不支持 5.0 Pro 的 fast。
layer_decomposition	boolean，默认 false	true 开启图层拆分，需要单张 PNG/JPEG 输入；false 为普通生成。
layer_decomposition_options	object，可选	仅拆分模式生效，包含下列两个选项。
layer_decomposition_options.max_images	integer，默认 30	范围 2–100，是包含底图在内的最大总输出数，不保证一定生成满额。
layer_decomposition_options.text_recognition	boolean，默认 false	开启规整文字图层的富文本 OCR；不保证艺术字或手写体可识别。
safety_identifier	string，可选	最长 64 字符的稳定英文用户标识，推荐使用哈希，避免直接提交用户邮箱等个人信息。

不使用其他图片模型的 resolution、quality、n 或 seed 控制本模型的档位与出图数量。5.5 的官方接口未将它们列为对应的生成控制参数；控制拆分数量应使用 layer_decomposition_options.max_images。

尺寸与参考图限制

普通生成有两种 size 写法，二选一：

• 档位：1K、1.5K、2K，默认 2K。在 prompt 中描述“16:9 横版”等构图要求，由模型决定具体宽高。
• 精确宽高：例如 2880x1440。宽×高必须在 921,600–4,624,220 之间，宽高比必须在 1:16–16:1 之间，两个条件须同时满足。512x512 像素不足；不支持 4K 档位。

图层拆分只接受 1K、1.5K、2K、auto，不接受精确宽高。auto 参考底图和各图层原始尺寸：有效尺寸范围内尽量保持原尺寸，小于 1K 的按 1K、大于 2K 的按 2K 输出，同时保持相应宽高比。各图层像素可能不同，必须按实际返回尺寸计费。

输入限制	普通图片生成 / 编辑	图层拆分
张数	最多 10 张	仅 1 张
文件格式	JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF	PNG、JPEG
单图大小	不超过 30 MB	不超过 30 MB
单图总像素	196–36,000,000，宽高均大于 14 px	262,144–36,000,000
宽高比	1:16–16:1	1:16–16:1

Base64 的媒体类型采用小写，例如 data:image/png;base64,...；URL 需要可供服务端访问。

单图编辑、多图融合与连续编辑

{
  "model": "doubao-seedream-5-5-261028",
  "prompt": "保留第一张图片的布局，把圆形改成第二张图中杯子的颜色，其他区域保持不变",
  "image": ["https://example.com/source.png", "https://example.com/reference.png"],
  "size": "1.5K",
  "output_format": "png",
  "watermark": false
}

单图编辑将 image 改为字符串即可。连续编辑是把上一轮的输出图作为下一轮的 image 再提交；接口不会自动保留会话，每轮都独立计费。用文字描述坐标、框选、箭头指示位置，或把标记画在参考图上；不要虚构 mask 等专用定位字段。

原生透明背景

{
  "model": "doubao-seedream-5-5-261028",
  "prompt": "一只精致的半透明蓝色玻璃蝴蝶，独立素材，无背景",
  "size": "1K",
  "output_format": "png",
  "background": "transparent",
  "watermark": false
}

5.5 支持文生透明图，也支持最多 10 张参考图生成透明图，输入图无需自带透明通道。background: "transparent" 与 output_format: "jpeg" 冲突。auto 由模型判断；响应的 background 表示产物实际为 transparent 或 opaque。

图层拆分与富文本 OCR

{
  "model": "doubao-seedream-5-5-261028",
  "image": "https://example.com/poster.png",
  "prompt": "将标题、圆形和方形拆成独立图层",
  "layer_decomposition": true,
  "layer_decomposition_options": {"max_images": 4, "text_recognition": true},
  "size": "auto",
  "output_format": "png",
  "response_format": "url",
  "watermark": false
}

最多返回 1 张底图 + 99 个图层。max_images: 4 表示底图与图层合计最多四张。不要发送 background。任一图层生成失败时，上游整体请求报错，不支持将失败任务当作部分成功。

每项 data[] 可包含：

返回字段	含义
url / b64_json	图片地址或 Base64，取决于 response_format；不要只读取第一张。
size	实际 宽x高，用于像素档位与费用计算。
output_format、background	实际文件格式、实际透明度类型；视场景返回。
z_index	底图为 0，其他图层从 1 递增，越大越靠上。
name、description	模型识别出的图层名称与内容说明。
bounding_box.absolute	在输出底图中的 [left,top,right,bottom] 像素坐标。
bounding_box.normalized	归一化到 0–1000 的同格式坐标。
text_recognition	仅开启 OCR 且当前图层被识别为规整文字时返回。

还原图层时，把图层缩放到 (right-left) × (bottom-top)，放在 (left,top)，按 z_index 从小到大叠加。归一化坐标需要乘目标画布宽高再除以 1000；图层图片本身尺寸不等于其在画布上占据的尺寸。

OCR 的 text_recognition.text 为完整文字；lines[] 包含各行的 bounding_box 与 runs[]。每个 run 有 text 和 style：similar_font_family、foreground_color（#RRGGBB）、bold、italic、underline、strikethrough、shadow、translucent。这些是识别的近似样式，不能当作原设计文件的精确属性；字体可能为 unknown，非文字、艺术字和手写体可能完全不返回 OCR。

响应、保存与错误

响应包含 created、model、data[]、usage.input_images、usage.generated_images。generated_images 包括底图及各图层；输入图数量不等于免费张数。按返回数据保存完整产物和元信息。官方原始图片 URL 生成后 24 小时失效，请及时下载或转存；后台预览和站内转存不应替代您自己的素材备份。

非法尺寸、参考图过多、透明 JPEG、拆分时传 background 等参数问题应修正请求后重试。鉴权、权限、限流、内容审核或上游故障应按错误类型处理，不要把错误响应当作成功，也不要通过无限重试产生额外费用。上游 IPM 按同模型版本的生成图片数限流；图层拆分按 max_images 预占，完成后返还多占额度，这与实际费用按输出数量结算是两件事。

官方参考：Seedream 5.5 教程、Image generation API、模型价格。参数核查日期：2026-11-13。