ZeroFA API

火山引擎 · 图像生成（豆包 Seedream）

豆包 Seedream 文生图与图生图接口，兼容 OpenAI SDK。ZeroFA 已适配火山的输出像素下限、缺少 edits 端点和固定返回 URL 等差异。

POSThttps://zerofa.ai/v1/images/generations

可用模型

豆包 Seedream 图像模型
doubao-seedream-5-0-260128文生图 / 图生图可选
Seedream 5.0，画质与一致性更强，推荐默认使用。
doubao-seedream-5-0-pro-260628文生图 / 图生图可选
Seedream 5.0 Pro，高质量版本；仅在实时模型列表显示时可用。
doubao-seedream-4-5-251128文生图 / 图生图可选
Seedream 4.5，上一代稳定版本。
doubao-seedream-4-0-250828文生图 / 图生图可选
Seedream 4.0，旧版兼容模型；仅在实时模型列表显示时可用。

文生图模型见 模型广场 并筛选图像类型。下表列出已支持的版本标识，具体可用版本以当前环境的实时模型列表为准；Seedream 按张计费。

请求参数

Header 参数
Authorizationstring必填
API Key，格式为 Bearer <key>。
示例：Bearer sk-zerofa-xxx
Content-Typestring必填
示例：application/json
Body 参数application/json
modelstring必填
豆包 Seedream 模型，可在上方查看可用模型。
示例：doubao-seedream-5-0-260128
promptstring必填
画面描述，越具体越可控，并支持中文。
示例：一只戴宇航头盔的柴犬，扁平插画，studio light
ninteger可选
生成张数，默认为 1。
示例：1
sizestring可选
输出分辨率。请注意下方火山特性中的像素下限。
示例：2048x2048
火山不支持 response_format，Seedream 固定返回图片 URL。

火山特性

  • 输出像素下限约为 1920×1920。较小的 size 会等比放大到达标，因此图片可能大于请求尺寸且生成更慢。需要精确控制时请直接使用 2048x2048 等达标尺寸。
  • 返回 URL 而不是 base64。链接为火山 TOS 临时签名地址，通常约 24 小时过期，请及时下载。
  • 支持两种图生图方式：推荐使用 /v1/images/generations 加 image URL；也可使用 OpenAI 兼容的 /v1/images/edits 上传文件。
  • 按实际图片张数计费，而不是 token；价格随 model 和 size 变化。

图生图 · 原生格式（推荐）

在 /v1/images/generations 请求中加入 image URL 即可使用原生图生图，不需要 multipart 上传。

额外 Body 参数（火山原生 i2i）
imagestring | string[]可选
参考图，可传 URL、base64 data URI 或数组。Seedream 支持 1–14 张；带 image 即进入图生图模式。
示例：https://...png
sequential_image_generationstring可选
disabled 默认为单图；auto 可一次生成多张组图。
示例：disabled
sequential_image_generation_optionsobject可选
组图配置，例如 max_images。auto 模式按实际返回张数计费。
示例：{"max_images":3}
原生图生图 · curl（image URL）
curl https://zerofa.ai/v1/images/generations \
  -H "Authorization: Bearer sk-zerofa-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "把背景换成夜晚的星空，保持主体不变",
    "image": "https://your-cdn.com/cat.png",
    "size": "2048x2048"
  }'
组图 · sequential=auto
{
  "model": "doubao-seedream-5-0-260128",
  "prompt": "基于这张图生成 3 个不同姿势的变体",
  "image": ["https://your-cdn.com/cat.png"],
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": { "max_images": 3 }
}
image 参数仅火山 Seedream 支持；其他厂商的图生图请使用 /v1/images/edits。

图生图 · OpenAI 兼容格式

POST/v1/images/edits

通过 multipart/form-data 上传图片和 prompt。ZeroFA 会将文件转换为 base64 并调用 Seedream generations，固定只生成一张；传 URL 或生成组图时请使用上方原生格式。

图像编辑 · curl（上传文件）
curl https://zerofa.ai/v1/images/edits \
  -H "Authorization: Bearer sk-zerofa-xxx" \
  -F "model=doubao-seedream-5-0-260128" \
  -F "prompt=把背景换成夜晚的星空" \
  -F "size=2048x2048" \
  -F "image=@source.png;type=image/png"

响应

data 数组每项为一张图片，url 是火山 TOS 临时链接。需要长期保存时请及时下载。

请求与响应体

用下面的示例确认请求格式与返回结构。需要在线发起请求时，点击页面顶部“调试”拉起在线运行面板。

curl https://zerofa.ai/v1/images/generations \
  -H "Authorization: Bearer sk-zerofa-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "一只戴宇航头盔的柴犬，扁平插画，studio light",
    "n": 1,
    "size": "2048x2048"
  }'
响应 · 200
{
  "created": 1780943800,
  "data": [
    { "url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-5-0/....jpeg?X-Tos-Expires=86400&..." }
  ]
}