Skip to content

Seedream 5.5 图像生成​

POST
/v1/images/generations

🤖 本页是给 AI Agent 读的接口文档

人类用户只需按「如何使用」中的方法教会 AI 怎么用。

Seedream 5.5 同时支持文生图和图生图,可输出 PNG、JPEG 或带透明背景的 PNG。

  • 文生图:根据提示词从零生成图像。
  • 图生图:使用 1–10 张参考图完成编辑与多参考图融合。
  • 透明 PNG:文生图和图生图均支持透明背景。
  • 支持 8 种常用宽高比及 1k、1.5k、2k 三档输出。
  • 参考图可使用公网 HTTPS URL 或 PNG、JPEG、WebP 的 Base64 Data URI。
  • 接口同步返回原始图片字节的 Base64。
  • 每次请求固定生成 1 张图像。
  • 这是同步接口。客户端读取超时请设为 480 秒;服务端实际等待上限以当前部署配置为准。

模型 ​

请求体中的 model 固定填写下面的模型 ID。

seedream-5.5

价格 ​

分辨率单张售价
1k / 1.5k¥0.15 / $0.0221
2k¥0.25 / $0.0368

按输出分辨率收取单张图像费用。透明 PNG 与同档普通图同价。参考图从第一张起每张加收 ¥0.05 / $0.0074。

  • 文生图:费用 = 对应分辨率的单张输出价
  • 图生图:费用 = 对应分辨率的单张输出价+参考图张数 × 每张参考图单价

认证 ​

使用 ClawPower API Key 进行 Bearer 认证,并在请求头中传入:

Authorization: Bearer <CLAWPOWER_API_KEY>

类型 HTTP (bearer)

请求体 ​

application/json
模式

请求体​

application/json

要调用的模型 ID,固定填写 seedream-5.5,不接受其他名称。

有效值"seedream-5.5"

图像生成或编辑说明。必须是包含非空白字符的 UTF-8 字符串。

输出图像的宽高比,省略时默认为 1:1。

有效值"1:1""4:3""3:4""16:9""9:16""3:2""2:3""21:9"
默认"1:1"

输出分辨率档位,省略时默认为 2k。

有效值"1k""1.5k""2k"
默认"2k"

省略时执行文生图。图生图传入 1–10 张有序参考图。支持公网 HTTPS URL 和 JPEG、PNG、WebP 的 Base64 Data URI。单张上限为 10,000,000 字节,请求整体仍受请求体大小限制。空数组和 null 无效。

最小项数1
最大项数10

背景模式。auto 由模型决定,transparent 生成透明背景,opaque 生成不透明背景。透明背景要求 PNG。

有效值"auto""transparent""opaque"
默认"auto"

请求的输出格式。background 为 transparent 时只能使用 png。

有效值"png""jpeg"
默认"png"

兼容字段,可省略或传整数 1。每次请求返回一张图片。

有效值1
默认1

响应​

生成成功。返回一张保留原始字节的图像。以下示例缩略了 Base64 内容。

application/json
JSON
{
  
"created": 1787270400,
  
"data": [
  
  
{
  
  
  
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
  
  
}
  
],
  
"output_format": "png",
  
"size": "2048x1152"
}

试验场​

授权
主体

示例​

生成模式 ​

模式触发条件请求说明
文生图省略 image_urls用 prompt 描述要生成的图像
图生图传入 image_urls提供 1–10 张有序参考图,用 prompt 说明如何编辑

文生图和图生图都可生成透明 PNG。将 background 设为 transparent,并使用 png 输出。

分辨率与宽高比 ​

字段可选值默认值
resolution1k、1.5k、2k2k
size1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:91:1

背景与输出格式 ​

字段可选值默认值
backgroundauto、opaque、transparentauto
output_formatpng、jpegpng

参考图限制 ​

参考图可用公网 HTTPS URL 或 Base64 Data URI。支持 JPEG、PNG、WebP,每张最大 10 MB(10,000,000 字节)。image_urls 必须为非空数组,请求整体仍受请求体大小限制。

完整调用示例 ​

成功响应中的 data[0].b64_json 是不带 data URI 前缀的原始图片 Base64。下面的 Python 示例发起同步请求,根据返回的 output_format 选择文件扩展名并保存。

python
import base64
import requests

response = requests.post(
    "https://api.clawpowerai.com/v1/images/generations",
    headers={
        "Authorization": "Bearer <CLAWPOWER_API_KEY>",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedream-5.5",
        "prompt": "一只橘猫坐在窗边看夕阳,水彩插画",
        "size": "16:9",
        "resolution": "2k",
    },
    timeout=480,
)
response.raise_for_status()

result = response.json()
extensions = {"png": ".png", "jpeg": ".jpg"}
filename = "output" + extensions[result["output_format"]]

with open(filename, "wb") as image_file:
    image_file.write(base64.b64decode(result["data"][0]["b64_json"], validate=True))

NOTE

这是同步接口。客户端读取超时请设为 480 秒。服务端实际等待上限以当前部署配置为准。

联系加微信 clawpower