跳转到主要内容
POST
Generate or edit an image

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
model
enum<string>
必填

模型 ID。

可用选项:
doubao-seedream-5-0-pro
示例:

"doubao-seedream-5-0-pro"

prompt
string
必填

图片生成或编辑提示词。如需坐标编辑,可在提示词中加入 标签。

示例:

"在标记区域添加一个带杯碟的陶瓷咖啡杯,并保持原始构图。"

image

参考图 URL/Base64 data URI,或参考图数组。图生图编辑时必填。Seedream 5.0 Pro 最多支持 10 张参考图。官方输入限制:格式支持 jpeg/png/webp/bmp/tiff/gif/heic/heif;单张图片不超过 30 MB;宽高比范围 [1/16, 16];宽和高均至少 14px;总像素不超过 36,000,000。

示例:
size
string

输出图片尺寸。可使用 1K、2K,或 2048x1024 这类像素尺寸。显式像素尺寸需要满足官方总像素和宽高比限制。

示例:
response_format
enum<string>
默认值:url

生成图片返回格式。URL 为临时链接,请及时保存。

可用选项:
url,
b64_json
output_format
enum<string>
默认值:jpeg

生成图片文件格式。

可用选项:
png,
jpeg
watermark
boolean
默认值:true

是否添加 AI 生成水印。

optimize_prompt_options
object

提示词优化配置。使用标准模式。官方文档说明 Seedream 5.0 Pro 不支持快速模式。

响应

Image generated successfully

model
string

本次请求使用的模型 ID。上游响应可能返回供应商侧模型名称。

示例:

"doubao-seedream-5-0-pro"

created
integer

请求创建时间,Unix 秒级时间戳。

示例:

1775029815

data
object[]

生成图片列表。

usage
object

用量信息。

error
object

请求级错误信息。