HAI Gateway 文档中心

火山引擎

Seedream 图片生成

基于火山引擎方舟 doubao-seedream 模型生成图片。支持文生图、图生图、多参考图融合、组图与流式生成，返回图片 URL 或 base64。

POSTv3/images/generations

本端点为火山引擎一等厂牌通道（对标 /openai、/anthropic、/google）。文生图、图生图、多参考图融合、组图（sequential_image_generation）、流式（stream）等所有模式都走这一条路由，仅通过请求体参数区分。

Authorizations

Authorizationstringheaderrequired

Use the following format for authentication: Bearer sk-pat-您的AccessToken

密钥的值使用 HAI Gateway 的个人访问令牌（以 sk-pat- 开头），无需在火山引擎处单独申请 ARK API Key。

Base URL

https://api.hai.network/volcengine

端点路径 v3/images/generations 与 api/v3/images/generations 等价，二者均可调用。本端点不提供模型列表接口（无 GET /models），请直接使用你在平台已开通 / 配置的模型 ID 调用。

Body 参数

modelstringbodyrequired

Seedream 系列图像模型，如 doubao-seedream-4-0-250828。当前覆盖 4.0 / 4.5 / 5.0-lite 系列；具体可调用的模型 ID 以你在 HAI Gateway 平台已开通 / 配置的为准。

promptstringbodyrequired

图像的文字描述（提示词）

imagestring | string[]body

参考图，用于图生图 / 多参考图融合。取值为图片 URL 或 base64 数据（data:image/...;base64,...）。传单张为图生图，传多张（数组）为多参考图融合

sizestringbody

输出分辨率。支持档位 1K / 2K / 4K，或显式像素尺寸如 2048x2048，默认 2K

seedintegerbody

随机种子，用于复现生成结果，默认 -1（随机）

sequential_image_generationstringbody

组图模式：disabled（默认，单张）/ auto（由模型自动决定是否生成一组关联图片）

sequential_image_generation_optionsobjectbody

组图选项，仅在 sequential_image_generation 为 auto 时生效。{ "max_images": <整数> } 限制本次最多生成的图片数

streambooleanbody

是否启用流式返回（以 SSE 逐张推送生成结果），默认 false，常与组图搭配使用

response_formatstringbody

返回格式：url（默认）/ b64_json。url 为临时地址，有效期 24 小时，请及时转存

watermarkbooleanbody

是否添加「AI 生成」水印，默认 true。设为 false 可关闭水印

toolsarraybody

工具列表。传入 [{ "type": "web_search" }] 可启用联网搜索增强；使用后响应 usage.tool_usage.web_search 会返回实际联网搜索次数

与 OpenAI Images API 的兼容性

请求结构与 OpenAI Images API 对齐（model / prompt / size / response_format），基础文生图可直接用 OpenAI 官方 SDK 的 images.generate() 指向本端点调用。但 Seedream 的差异化能力——2K / 4K 分辨率、watermark、image 图生图 / 多参考图融合、sequential_image_generation 组图、stream 流式、tools 联网搜索——属于火山扩展，超出 OpenAI 契约，需按本文参数调用。

完整参数说明以火山引擎方舟图片生成 API 官方文档为准。

cURL
cURL:Default
curl https://api.hai.network/volcengine/v3/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-pat-您的Access Token" \
  -d '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "一只在草地上奔跑的柴犬，电影感，柔和光线",
    "size": "2K",
    "response_format": "url"
  }'
200
200:Default
{
  "model": "doubao-seedream-4-0-250828",
  "created": 1717400000,
  "data": [
    {
      "url": "https://ark-content-generation.../image.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1
  }
}