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 |