Seedream-5.5 图像生成 | ToAPIs Documentation

POST

/v1/images/generations

国内用户请注意: 中国大陆用户请使用 https://toapis.cn 作为接口地址 (Base URL).文档示例中的 https://toapis.com 请替换为 https://toapis.cn.

通过 doubao-seedream-5-5 提交文生图, 参考图编辑或图层拆分任务. 接口先返回任务 ID, 再通过任务查询获取结果.

每次返回一张结果图.

Authorizations

Authorizationstring请求头必填

所有接口均需要使用 Bearer Token 进行认证

获取 API Key: 访问 API Key 管理页面获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

Body

modelstring请求体必填默认值: doubao-seedream-5-5

图像生成模型名称

示例: "doubao-seedream-5-5"

promptstring请求体

普通生图和编辑必填的文字描述. 启用 layer_decomposition 时可以省略, 由模型自动识别要拆分的元素.

sizestring请求体默认值: 2K

支持 1K, 1.5K, 2K 预设, 或 WIDTHxHEIGHT 显式像素尺寸, 例如 2048x2048. 预设表示分辨率档位, 不固定输出宽高比. 显式尺寸的像素总数范围为 921600-4624220. 固定正方形请使用 2048x2048, 不要直接传 1:1. 普通生图省略时使用 2K; 图层拆分建议显式传 2K.

image_urlsstring[]请求体

参考图像 URL 列表, 用于图像编辑或多图参考.

最多 10 张参考图.
仅支持公开可访问的 HTTP/HTTPS URL, 不支持直接传入 base64 数据.
本地图片请先通过上传图片接口上传并获取 URL.
也可使用 reference_images 或 images 数组字段.

imagestring请求体

单张参考图的 URL 字符串. 多张参考图请使用 image_urls, 不要把数组放入 image.

layer_decompositionboolean请求体

设置为 true 时拆分唯一一张参考图. 可省略 prompt; 请省略组图参数. 返回底图和多个透明 PNG 图层, 包含 z_index, 图层定位信息和名称. 当前接口最多处理 1 个底图和 16 个图层, 未提供图层数量或 OCR 设置.

optimize_prompt_optionsobject请求体

提示词优化选项, 使用 {"mode": "standard"}. Seedream 5.5 不接受 fast.

metadataobject请求体

渠道特有参数, 用于传递 Seedream 5.5 模型的高级配置

metadata 属性

metadata.output_formatstring请求体默认值: png

输出格式为 png 或 jpeg. 需要透明背景时请使用 png.

metadata.backgroundstring请求体

可传 opaque 或 transparent. 透明背景不能与 output_format=jpeg 同时使用; 设置 transparent 且省略格式时使用 PNG. 当前接口不接受显式的 auto.

metadata.watermarkboolean请求体默认值: false

是否添加可见的 AI generated 水印. false 关闭可见水印, true 开启. 该选项不代表移除来源元数据或隐形标记.

metadata.response_formatstring请求体默认值: url

本页使用 url 模式. 图片通过异步任务查询结果中的 URL 交付.

参数限制

不支持普通组图. 请省略 sequential_image_generation 和 sequential_image_generation_options, 即使取值为 disabled 也会被上游拒绝. 不支持 stream=true; 可省略 stream 或使用 false. 当前接口不支持 tools 联网搜索参数和 seed.

查询任务

提交成功不代表生成完成. 使用同一个 API Key 查询任务. 状态可能为 pending, queued, in_progress, completed 或 failed. 完成后读取 result.data; 失败时读取 error.

curl "https://toapis.com/v1/images/generations/TASK_ID" \
  -H "Authorization: Bearer $TOAPIS_API_KEY"

Response

idstring

任务唯一标识符, 用于查询任务状态

objectstring

对象类型, 固定为 generation.task

modelstring

使用的模型名称

statusstring

任务状态

queued - 排队等待处理
in_progress - 处理中
completed - 成功完成
failed - 失败

progressinteger

任务进度百分比(0-100)

created_atinteger

任务创建时间戳(Unix 时间戳)

metadataobject

任务元数据

result.dataarray

完成后的图片列表. 普通生图为一项, 图层拆分为多项.

result.data[]object

图片 URL, 实际像素尺寸和输出格式.

result.data[].z_indexinteger

图层的堆叠顺序. 0 为底图; 其余图层还可返回 bounding_box, name, description.

执行示例前设置 TOAPIS_API_KEY 环境变量. 参考图示例中的 example.com 是占位地址, 请替换为可访问的图片 URL.

请求示例

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedream-5-5",
  "prompt": "A red toy sailboat and a small yellow sun, isolated objects, no text.",
  "size": "2K",
  "metadata": {
    "output_format": "png",
    "background": "transparent",
    "watermark": false,
    "response_format": "url"
  }
}'

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedream-5-5",
  "prompt": "Combine the subjects from both references into one product illustration.",
  "size": "2K",
  "image_urls": [
    "https://example.com/reference-front.png",
    "https://example.com/reference-side.jpg"
  ],
  "metadata": {
    "output_format": "png",
    "watermark": false,
    "response_format": "url"
  }
}'

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedream-5-5",
  "image": "https://example.com/composition.png",
  "layer_decomposition": true,
  "size": "2K",
  "metadata": {
    "output_format": "png",
    "watermark": false,
    "response_format": "url"
  }
}'

响应示例

{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "doubao-seedream-5-5",
  "status": "pending",
  "progress": 0,
  "created_at": 1794300000,
  "metadata": {}
}

{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "doubao-seedream-5-5",
  "status": "completed",
  "progress": 100,
  "created_at": 1794300000,
  "metadata": {},
  "result": {
    "type": "image",
    "data": [
      {
        "url": "https://files.toapis.com/images/example/seedream-5-5.png",
        "size": "2512x1680",
        "output_format": "png"
      }
    ]
  }
}