ToAPIs
home
登录免费试用

快速结论

  • 使用 model=doubao-seedream-5-5 调用异步图片任务接口.
  • size 支持 1K/1.5K/2K 档位或显式宽高像素, 总像素 921600-4624220.
  • metadata.background=transparent 输出 RGBA PNG; 图层拆分的总输出上限含底图, max_images 可设 2 到 100, 默认 30.

关键参数

  • model | string | 必填 | doubao-seedream-5-5 | - | 固定使用 doubao-seedream-5-5 作为模型标识.
  • prompt | string | 可选 | - | - | 普通生图和改图必填; layer_decomposition=true 时可省略.
  • size | string | 可选 | - | 1K | 1.5K | 2K | WIDTHxHEIGHT | 普通生图采用模型默认分辨率, 分层省略时为 auto. 档位不固定比例, 显式宽高总像素 921600-4624220.
  • image_urls | string[] | 可选 | - | 0-10 | 通过 image_urls 提供 1 到 10 张 JPEG, PNG 或 WEBP 参考图. 本地文件需先上传, 再使用返回的 URL.
  • n | integer | 可选 | 1 | 1 | 仅支持 1 或省略. 普通生图输出 1 张, 此字段不是分层图层数量.
  • layer_decomposition | boolean | 可选 | false | - | 普通生图关闭. 开启时必须恰好一张参考图并省略 metadata.background. 返回底图和透明 PNG 图层, 总输出上限由 layer_decomposition_options.max_images 控制.
  • layer_decomposition_options.max_images | integer | 可选 | 30 | 2-100 | 分层模式的总输出上限, 包含底图, 不是保证生成的固定张数. 实际数量由模型决定.
  • layer_decomposition_options.text_recognition | boolean | 可选 | - | - | 控制图层拆分的文字识别. 仅在上游返回时, 任务结果才包含 text_recognition 元数据.
  • metadata.output_format | string | 可选 | - | png | jpeg | 未指定时沿用上游默认格式, 透明背景自动为 png. 分层时仅控制底图, 其余图层始终为 PNG.
  • metadata.background | string | 可选 | - | auto | opaque | transparent | 仅普通生图和改图使用. layer_decomposition=true 时必须省略, opaque 也不支持. transparent 输出 RGBA PNG, 不可配 jpeg.
  • metadata.watermark | boolean | 可选 | - | - | 设为 false 关闭可见水印.
  • metadata.response_format | string | 可选 | url | url | b64_json | 结果返回形式; 推荐使用 url.

常见错误

  • 400 invalid_input: 触发=size 像素超出范围, 参考图超过 10 张, 或 layer_decomposition 未恰好传一张输入图.; 修复=按文档校验 size, image_urls 数量与 layer_decomposition 的输入约束.; 重试=修正参数后重试, 不建议盲重试.
  • 429 rate_limit_exceeded: 触发=请求频率, 并发或额度命中限流策略.; 修复=先做指数退避重试, 再检查请求节奏与额度使用.; 重试=建议 1s/2s/4s 退避并加入抖动.
ByteDance Seed logo

Seedream 5.5

可商用

支持文生图和参考图编辑, 一次最多可用 10 张参考图. 可直接生成带透明背景的 RGBA 图片, 多轮编辑时也能保留未修改区域的像素. 开启图层拆分后, 可将一张参考图拆成底图和独立的透明 PNG 图层.

模型类型：
文生图图生图
价格： 1K / 1.5K 3.2 积分（¥0.112）/ 张; 2K 5.6 积分（¥0.196）/ 张
正常
1

描述你的图片

参考图

图层拆分可不填提示词, 留空时直接拆分参考图.52 / 1200

高级选项

示例参数
图层拆分
文字识别

图层拆分需要且仅允许 1 张参考图, 不支持背景设置. 普通生图请关闭此选项.

2

你的生成结果

示例结果
查看 API 文档获取 API Key

生成需要一些时间，请稍等您可以离开此页面，[ 任务日志 ] 可直接检查生成的内容

请求预览

{
  "model": "doubao-seedream-5-5",
  "prompt": "一组刺绣牛仔贴布贴纸, 透明背景: 泰迪熊, 雏菊, 樱桃, 彩虹, 蝴蝶, 爱心与星星, 逼真缝线质感",
  "size": "2K",
  "metadata": {
    "watermark": false,
    "background": "transparent"
  }
}

5.5

模型版本

10

参考图上限

100

分层输出上限(含底图)

2K

最高输出档位

生成案例

探索 Seedream 5.5 的生成效果

使用同款模型生成
通过 ToAPIs Seedream 5.5 API 生成的透明刺绣贴纸图

ToAPIs API 生成

Seedream 5.5 官方展示的透明 PNG 素材生成效果

官方示例

Seedream 5.5 官方展示的局部精准编辑效果

官方示例

透明计价

Seedream 5.5 价格

按生成图片计费, 各输出尺寸档位均为字节官方标价的 8 折.

充值积分

1K / 1.5K

ToAPIs

¥0.112

3.2 积分 / 张

节省 20%VS

字节官方标价

¥0.14

张

2K

ToAPIs

¥0.196

5.6 积分 / 张

节省 20%VS

字节官方标价

¥0.245

张

普通生图返回一张图片, 图层拆分返回底图和 PNG 图层. 费用在任务完成后结算.

为什么选择 ToAPIs

为什么在 ToAPIs 使用 Seedream 5.5 API?

通过一个接口构建透明输出, 稳定迭代编辑与按图计费的生产级图片工作流.

原生透明素材

将 metadata.background 设为 transparent 即可直接获得 RGBA PNG 输出, 贴纸, 图标与商品抠图无需额外抠图步骤.

像素级多轮编辑

对同一张图连续多次编辑, 未编辑区域逐轮保持一致, 每次修改最多可用 10 张参考图引导.

可编辑图层输出

将一张图拆成底图和透明 PNG 图层. layer_decomposition_options.max_images 可设为 2 到 100, 包含底图, 默认 30. 实际输出数量由模型决定.

三步调用 Seedream 5.5 API

Seedream 5.5 在 ToAPIs 上以异步图片任务运行: 提交, 轮询, 下载结果.

  1. 1

    创建 API 密钥

    在 ToAPIs 控制台创建密钥, 使用 model 为 doubao-seedream-5-5 调用 POST /v1/images/generations.

  2. 2

    选择工作流与参数

    可选文生图, 最多 10 张 image_urls 的参考编辑, 或 layer_decomposition 图层拆分; size 支持 1K, 1.5K, 2K 或显式宽高, metadata 控制 output_format, background 与 watermark.

  3. 3

    轮询任务并取回图片

    提交响应返回 task_id, 轮询任务接口直到状态为 completed, 再下载结果图片链接.

Seedream 5.5 适用场景

透明贴纸与设计素材

直接产出 RGBA 贴纸, 图标, 徽标与商品抠图, 可立即放入设计稿或店铺素材.

迭代修图工作流

对人像, 室内与商品图连续修改, 未触及区域保持像素级一致.

面向设计管线的图层提取

把成品图拆成底图加透明 PNG 图层, 直接进入 Figma, Photoshop 或印刷流程.

常见问题

Seedream 5.5 API 常见问题

在 ToAPIs 上调用 Seedream 5.5 用哪个模型 ID?

使用 model 为 doubao-seedream-5-5 提交 POST /v1/images/generations. 接口为异步: 提交响应返回 task_id, 轮询至任务完成.

Seedream 5.5 支持哪些尺寸?

size 可传 1K, 1.5K 或 2K 档位, 或 2048x2048 这类显式宽高; 总像素需在 921600 到 4624220 之间.

一次请求可以带多少张参考图?

通过 image_urls 最多 10 张 (images 与 reference_images 为等价别名), 支持 JPEG 与 PNG 输入, 每次响应返回一张结果图.

如何生成透明 PNG?

将 metadata.background 设为 "transparent"; 不显式指定格式时接口返回 RGBA PNG, 也可显式将 metadata.output_format 设为 "png".

layer_decomposition 返回什么?

设置 layer_decomposition=true 并传入恰好一张参考图, 返回底图和透明 PNG 图层. layer_decomposition_options.max_images 限制总输出数量, 包含底图, 可设为 2 到 100, 默认 30, 实际数量由模型决定. prompt 可省略, 请省略 metadata.background. layer_decomposition_options.text_recognition 控制文字识别, 上游提供时返回 OCR 元数据.

Seedream 5.5 多轮编辑能保持未编辑区域稳定吗?

可以. Seedream 5.5 面向多轮编辑设计, 修改区域以外的画面在逐轮编辑中保持一致, 迭代修图不会漂移.

Seedream 5.5 在 ToAPIs 的价格是多少?

按生成图片计费, 为官方标价的 8 折: 1K 与 1.5K 输出每张 $0.016 (官方 $0.02), 2K 输出每张 $0.028 (官方 $0.035).

如何关闭水印?

在请求中将 metadata.watermark 设为 false, 即可获得不带可见水印的输出.

Seedream 5.5 API

在 ToAPIs 使用 Seedream 5.5 构建

在 Playground 试用 Seedream 5.5, 或阅读 API 参考将透明输出, 参考图编辑与图层拆分接入你的图片管线.

立即试用查看 API 文档

ToAPIs 上的 Seedream 5.5 API

一个接口覆盖文生图, 多参考图编辑, 透明 RGBA 输出与图层拆分, 按图计费.

试用 Seedream 5.5