跳转到主要内容
POST
Doubao Seedream 生成图像 API

Doubao Seedream 生成图像 API

Doubao Seedream 系列通过统一图像生成入口发起请求,适合文生图,也支持通过 image 数组传参考图做图生图。
  • 统一入口为 POST /v1/images/generations
  • model 传具体 Seedream 型号即可。
  • size 直接传像素尺寸字符串,例如 2048x20482560x1440
  • image 支持图片 URL 或 Base64 数组,适合图生图和多参考图场景。
  • 返回通常兼容 OpenAI Images 风格,常见为 urlb64_json

当前可用模型

  • doubao-seedream-4-0-250828
  • seedream-4-0-250828
  • doubao-seedream-4-5-251128
  • doubao-seedream-5-0-260128

方法与路径

请求示例

图生图示例

响应示例

认证

Body

model
string
必填
Doubao Seedream 模型名称。常见值包括 doubao-seedream-4-0-250828doubao-seedream-4-5-251128doubao-seedream-5-0-260128
prompt
string
必填
生成提示词。文生图和图生图都建议显式传入。
n
integer
生成数量。你给的 Apifox 将其作为必填;从现有统一图像 DTO 看,这个字段在网关里是可选指针类型。若要和当前插件行为保持一致,建议传 1
size
string
输出尺寸,直接传宽高像素值。Doubao 这组模型通常按固定比例映射到固定像素尺寸。
image
array<string> | string
可选参考图输入。你给的 Apifox 定义为“图片链接或者 BASE64 数组”,当前插件也是把参考图编码成 Base64 数组后放进这个字段。
response_format
string
可选返回格式。常见值为 urlb64_json。若不传,最终返回格式取决于上游和网关兼容层。
quality
string
质量字段。统一图像 DTO 支持接收,但 Doubao 是否实际消费该字段取决于最终上游。
style
string | object
风格字段。统一图像 DTO 支持接收,是否生效取决于具体 Doubao 渠道。
background
string | object
背景控制字段。统一图像 DTO 支持接收,是否生效取决于具体 Doubao 渠道。
watermark
boolean
显式水印开关。当前统一图像 DTO 中该字段使用指针类型,false 与不传语义不同。

尺寸映射

你给的 Apifox 和插件里的 DOUBAO_SIZE_MAP 一致,可按下表使用:
和 Gemini 不同,Doubao 这组接口在你现有插件里不是传“比例枚举”,而是先把比例映射成具体像素尺寸,再把该尺寸写入 size

文生图 vs 图生图

Response

created
integer
生成时间戳。
data[].url
string
返回图片 URL。当前插件遇到该字段时会再下载到本地。
data[].b64_json
string
返回图片 Base64 数据。当前插件会优先使用这个字段。
data[].revised_prompt
string
部分上游会返回调整后的提示词。

相关接口