Seedream 5.5 API 指南：价格、参数与调用示例

Seedream 5.5 能做什么

Seedream 5.5 是 HiAPI 上的一个图像模型，一个模型 ID（seedream-5.5）同时覆盖两种用法：只写提示词就是文字生成图片；再附上参考图，就是按参考图编辑或保留画面内容。两种用法走同一个接口、同一套参数，区别只在于请求里有没有 image_urls。

每次调用返回一张图。下面按「价格怎么算 → 参数怎么填 → 请求怎么发 → 有哪些限制」的顺序说明，所有数字都以本文写作时的接口定义为准。

价格：按像素档位计费，参考图逐张加收

费用由两部分组成：输出档位的基础价，加上参考图费用。

• 1K / 1.5K：$0.0186 / 张
• 2K（默认档位）：$0.0325 / 张
• 参考图：每张 $0.0075，第一张也计费，最多 10 张

举几个例子：

• 1K 文字生成图片，不带参考图：$0.0186
• 2K，带 1 张参考图：$0.0325 + $0.0075 = $0.04
• 2K，带 10 张参考图（上限）：$0.0325 + $0.075 = $0.1075

不写 size 时按 2K 出图、按 2K 计费。只是做草图或小尺寸配图，显式写 "size": "1K" 能省下约四成。任务失败时费用全额退还。

参数一览

除 model 和 prompt 外都是可选参数：

• prompt：必填，1–5000 字符。描述要生成的画面；带参考图时写清楚要改什么、保留什么。
• size：1K、1.5K、2K，默认 2K。
• aspect_ratio：10 种可选——1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9、2:1、1:2。不写时由模型根据提示词和参考图自动选择。
• image_urls：1–10 个公开可访问的 http(s) 图片地址。不写就是纯文字生成。
• output_format：png 或 jpeg，默认 png。
• background：auto、transparent、opaque，默认 auto。选 transparent 时输出格式只能是 png，搭配 jpeg 会被拒绝。

发一个请求

HiAPI 的图像任务是异步的：先创建任务，再查询结果。model 放在顶层，其余参数放进 input。

文字生成图片（2K、16:9）：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.5",
    "input": {
      "prompt": "清晨的海边灯塔，薄雾，柔和的侧光，写实摄影风格",
      "size": "2K",
      "aspect_ratio": "16:9"
    }
  }'

参考图编辑（1K、透明背景、PNG）：

{
  "model": "seedream-5.5",
  "input": {
    "prompt": "保留瓶身和标签，去掉背景，换成柔和的顶光",
    "image_urls": ["https://example.com/bottle.jpg"],
    "size": "1K",
    "background": "transparent",
    "output_format": "png"
  }
}

这一单的费用是 $0.0186 + $0.0075 = $0.0261。创建成功后拿返回的任务 ID 调 GET https://api.hiapi.ai/v1/tasks/{taskId} 轮询，状态变成成功后从输出里取图片地址下载。

当前限制

• 最高 2K，没有 4K 档位。
• 不支持图像分层输出。
• 每次调用只出一张图，要多张就并发发多个任务。
• 参考图必须是公网能访问的 http(s) 地址，不接受本地文件路径或 base64。
• 透明背景只支持 PNG。

怎么选档位

需要直接上线的海报、商品主图，用默认的 2K；内部评审稿、批量试风格、小尺寸缩略图，用 1K 或 1.5K（两者同价，1.5K 更清楚，没有理由选 1K 时直接用 1.5K）。参考图按张收费，只放真正影响结果的那几张；同一个商品的多角度图，先用 1–2 张试，效果不够再加。