Doubao 图像生成

Doubao Seedream 系列通过统一图像生成入口发起请求，适合文生图，也支持通过 数组传参考图做图生图。

POST /v1/images/generations

通过 选择 Seedream 型号；尺寸按比例映射为具体像素值（见下方尺寸映射表），返回兼容 OpenAI Images 风格。

当前可用模型

请求头

名称	类型	必填	说明
	string	是	请求身份认证。使用 Bearer Token，示例：
	string	是	请求内容类型，必须设置为

请求体

名称	类型	必填	说明
	string	是	Doubao Seedream 模型名称，常见值见上方「当前可用模型」
	string	是	生成提示词。文生图和图生图都建议显式传入
	integer	否	生成数量，建议传 。不传或显式传 时统一层回退为
	string	否	输出尺寸，直接传宽高像素值。Doubao 这组模型通常按固定比例映射到固定像素尺寸，见下方「尺寸映射」
	array<string> | string	否	可选参考图输入：图片 URL 或 Base64 数组，适合图生图和多参考图场景
	string	否	可选返回格式，常见值为 、。若不传，最终返回格式取决于上游和网关兼容层
	string	否	质量字段。统一图像 DTO 支持接收，是否实际消费取决于最终上游
	string | object	否	风格字段。统一图像 DTO 支持接收，是否生效取决于具体 Doubao 渠道
	string | object	否	背景控制字段。统一图像 DTO 支持接收，是否生效取决于具体 Doubao 渠道
	boolean	否	显式水印开关。 与不传语义不同

尺寸映射

宽高比	值

请求示例

文生图

curl -X POST https://octopusx.ai/v1/images/generations \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seedream-4-0-250828",
  "prompt": "一只可爱的小海獭，阳光下漂浮在海面，电影感，高清细节",
  "n": 1,
  "size": "2048x2048"
}'

图生图

curl -X POST https://octopusx.ai/v1/images/generations \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seedream-4-5-251128",
  "prompt": "保留参考图主体和氛围，重绘成更高级的广告海报",
  "n": 1,
  "size": "2560x1440",
  "image": [
    "BASE64_IMAGE_1",
    "https://example.com/reference-2.png"
  ]
}'

响应示例

200 - URL

{
  "created": 1735689600,
  "data": [
    {
      "url": "https://.../images/doubao-img-abc123.png",
      "revised_prompt": "一只可爱的小海獭，阳光下漂浮在海面，电影感，高清细节"
    }
  ]
}

200 - Base64

{
  "created": 1735689600,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "revised_prompt": "一只可爱的小海獭，阳光下漂浮在海面，电影感，高清细节"
    }
  ]
}

响应字段

名称	类型	说明
	integer	生成时间戳
	array<object>	生成结果数组
	string	返回图片 URL
	string	返回图片 Base64 数据
	string	部分上游会返回调整后的提示词

注意事项

INFO

和 Gemini 不同，Doubao 这组接口不是传「比例枚举」，而是先把比例映射成具体像素尺寸，再把该尺寸写入 。

相关接口

• 图像系列概览
• 错误码查询