Seedream 5.5 接口文档

支持 1K、1.5K、2K 输出、透明背景 PNG 直出及最多 10 张参考图融合,采用固定按张计费。

POST /v1/images/generations · seedream-5.5

请求参数说明

seedream-5.5 采用固定按张计费,单张费用仅由 quality("1K" | "1.5K" | "2K")与可选 image_urls 张数(1..10)决定,与画幅比例和提示词长度无关。当 background 设为 "transparent" 时,output_format 必须为 "png"。

参数字段类型与默认值取值范围与说明
Authorization
必填Header
string
Bearer cm_live_... 格式的服务端 API Key。
Idempotency-Key
可选Header
string默认: recommended
1 至 255 位 ASCII 字符;24 小时内及任务完成前防止重复提交与重复扣费。
model
必填
"seedream-5.5"
Seedream 5.5 稳定公开模型 ID。
prompt
必填
string
非空 UTF-8 画面或编辑描述提示词。
quality
可选
"1K" | "1.5K" | "2K"默认: "1K"
输出清晰度档位(1K / 1.5K 为 1.88 积分,2K 为 3.29 积分)。
size
可选
"auto" | "1:1" | "16:9" | "9:16" | ...默认: "1:1"
支持 auto 及 11 种标准比例,画幅比例不影响单张价格。
output_format
可选
"png" | "jpeg"默认: "png"
输出格式(background 设为 transparent 时必须为 png)。
background
可选
"opaque" | "transparent" | "auto"默认: "opaque"
背景模式:支持 transparent 直出透明通道 PNG。
image_urls
可选
string[] (1..10)默认: omitted
可选 1 至 10 张参考图 HTTPS 链接(每张加收 0.752 积分)。

透明通道 PNG 直出与参考图编辑示例

搭配 background: "transparent" 与 output_format: "png" 可直接输出带 Alpha 透明通道的商品免抠图与 UI 素材。

curl -sS -X POST "https://api.callmodels.dev/v1/images/generations" \
  -H "Authorization: Bearer $CALLMODELS_API_KEY" \
  -H "Idempotency-Key: img_req_20261115_01" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5.5",
  "prompt": "Botanical white orchid stem with crystal water droplets, isolated clean edges",
  "size": "1:1",
  "quality": "1.5K",
  "output_format": "png",
  "background": "transparent"
}'

响应结构示例

纯文生图 1K / 1.5K 完成后实扣恒为 "1.88" 积分(传入 1 张参考图则恒为 "2.632" 积分)。

{
  "id": "task_01e561ba-859e-47fe-be79-60bc6f1d6499",
  "model": "seedream-5.5",
  "object": "image.generation.task",
  "status": "pending",
  "created_at": "2026-11-15T09:49:18.000Z"
}

固定按张计费价格表

任何画幅比例与提示词长短均不影响单张价格,适合固定单价商业产品预算核算。

规格档位Callmodels 积分折合美元官方参考价
1K 或 1.5K 输出 · 纯文生图(0 张参考图)1.880000 积分$0.0188$0.020
2K 高清输出 · 纯文生图(0 张参考图)3.290000 积分$0.0329$0.035
参考图附加费(image_urls 每传入 1 张,上限 10 张)+0.752000 积分 / 张+$0.00752+$0.008