可用模型
加载中…
文生图模型见 模型广场 并筛选图像类型。下表列出已支持的版本标识，具体可用版本以当前环境的实时模型列表为准；Seedream 按张计费。
请求参数
Header 参数
Authorizationstring必填API Key，格式为 Bearer <key>。
示例：
Bearer sk-zerofa-xxxContent-Typestring必填示例：
application/jsonBody 参数application/json
modelstring必填豆包 Seedream 模型，可在上方查看可用模型。
示例：
your-seedream-model-idpromptstring必填画面描述，越具体越可控，并支持中文。
示例：
一只戴宇航头盔的柴犬，扁平插画，studio lightninteger可选生成张数，默认为 1。
示例：
1sizestring可选输出分辨率。请注意下方火山特性中的像素下限。
示例：
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://...pngsequential_image_generationstring可选disabled 默认为单图；auto 可一次生成多张组图。
示例：
disabledsequential_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": "your-seedream-model-id",
"prompt": "把背景换成夜晚的星空，保持主体不变",
"image": "https://your-cdn.com/cat.png",
"size": "2048x2048"
}'组图 · sequential=auto
{
"model": "your-seedream-model-id",
"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=your-seedream-model-id" \
-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": "your-seedream-model-id",
"prompt": "一只戴宇航头盔的柴犬，扁平插画，studio light",
"n": 1,
"size": "2048x2048"
}'响应 · 200
{
"created": 1780943800,
"data": [
{ "url": "https://upstream-cdn.example.com/generated/image.jpeg?..." }
]
}