跳转到主要内容
POST

Authorizations

Authorization
string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:
单图模型doubao-seedream-5-0-pro 每次请求仅生成 1 张图像,质量优先。以下参数不受支持,传入会被拒绝(返回 400):
  • n > 1(组图数量)

Body

model
string
默认值:"doubao-seedream-5-0-pro"
必填
图像生成模型名称支持的模型:doubao-seedream-5-0-proExample: "doubao-seedream-5-0-pro"
prompt
string
必填
图像生成的文本描述
建议: 控制在 600 英文单词以内,描述过长可能导致细节丢失。
size
string
默认值:"1:1"
图像生成的宽高比支持的宽高比:
  • 1:1 - 正方形(默认)
  • 4:3 - 横向 4:3
  • 3:4 - 纵向 3:4
  • 16:9 - 横向宽屏
  • 9:16 - 纵向竖屏
  • 3:2 - 横向 3:2
  • 2:3 - 纵向 2:3
  • 21:9 - 超宽屏
  • auto - 由模型根据 prompt / 参考图自动决定宽高比
注意: 不支持自定义像素值;列表外的取值(如 9:21)会被直接拒绝,返回 400。
resolution
string
默认值:"2K"
图像分辨率支持的分辨率:
  • 1K - 标准分辨率
  • 2K - 高清分辨率(默认)
注意: doubao-seedream-5-0-pro 仅支持 1K 和 2K,传入 3K / 4K 等档位会返回 400。
分辨率参考尺寸:
size: "auto" 时仅下发分辨率档位(1K / 2K),最终宽高比由模型自动判断。
image_urls
array
参考图像的 URL 列表,用于单图 / 多参考图生图,最多 10 张支持两种格式:1. 完整的图像URL地址
  • 公开可访问的图像URL(http:// 或 https://)
  • 示例:https://example.com/image.jpg
2. Base64 编码格式
  • 必须使用完整的 Data URI 格式
  • 格式:data:image/{格式};base64,{base64数据}
  • 示例:data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ 注意:必须包含 data:image/jpeg;base64, 前缀部分
单张图片限制:
  • 图片格式:jpeg、png、webp、bmp、tiff、gif、heic、heif
  • 宽高比(宽/高)范围:[1/16, 16]
  • 宽高长度(px)> 14
  • 单张图片大小:不超过 30MB
  • 总像素:不超过 6000×6000 px
计费: 单次请求中,第一张参考图免费,之后每张参考图额外计费。
output_format
string
默认值:"jpeg"
输出图片格式
  • jpeg:JPEG 格式(默认)
  • png:PNG 格式,适用于需要透明背景等场景
兼容: response_formatoutput_format 等价,其余取值按 jpeg 处理。
watermark
boolean
默认值:"false"
是否在生成的图像右下角添加 “AI generated” 水印
  • true:添加水印
  • false:不添加水印(默认)
⏱️ 生成较慢:1K 约 90 秒、2K 约 160 秒(Pro 模型质量优先)。提交后每 5~10 秒轮询一次 GET /v1/tasks/{task_id},建议客户端轮询超时设为 5 分钟。任务失败会自动全额退款。

Response

code
integer
响应状态码
data
array
返回数据数组