跳转到主要内容
POST
图片生成

授权

Authorization
string
header
必填

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

请求体

application/json

使用 Doubao Seedream 5.0 Pro 根据文字生成图片。

model
string
必填

必填。使用 Get Models 返回的模型 ID 或可用别名。

Minimum string length: 1
示例:

"volcengine/doubao-seedream-5.0-pro"

"volcengine/doubao-seedream-4.5"

prompt
string
必填

图片生成提示词。官方建议不超过约 300 个中文字符或 600 个英文单词。

Minimum string length: 1
示例:

"一座漂浮在云海上的未来城市,日出时分,电影级光影,建筑细节丰富"

size

doubao-seedream-5.0:支持 2K 、 3K 或指定宽高像素值;默认 2048x2048 ;总像素范围 [2560x1440, 3072x3072x1.1025] ;宽高比范围 [1/16, 16] 。 doubao-seedream-4.5:支持 2K、4K 或指定宽高像素值;默认 2048x2048;总像素范围 [2560x1440, 4096x4096];宽高比范围 [1/16, 16]。 doubao-seedream-4.0:支持 1K、2K、4K 或指定宽高像素值;默认 2048x2048;总像素范围 [1280x720, 4096x4096];宽高比范围 [1/16, 16]。

可用选项:
auto,
1K,
1.5K,
2K
output_format
enum<string>
默认值:jpeg

输出图片格式。透明背景必须使用 png。

可用选项:
png,
jpeg
background
enum<string>
默认值:opaque

输出背景。transparent 仅可与 output_format=png 一起使用。

可用选项:
opaque,
transparent
response_format
enum<string>
默认值:url

Tikway 图片交付格式,url 返回图片链接,b64_json 返回纯 Base64。默认 url;该字段由网关消费,不作为上游模型参数。

可用选项:
b64_json,
url
watermark
boolean
默认值:true

是否在生成图片中添加水印。

optimize_prompt_options
object

火山引擎提示词优化设置。

images
(string | object)[]

可选。图生图参考图;省略时为文生图。5.0 Pro 最多 10 张,4.5 最多 14 张;具体可用能力以所选模型为准。

Required array length: 1 - 14 elements
Minimum string length: 1

响应

200 - application/json

Doubao Seedream 5.0 Pro 图片生成成功响应。

created
integer<int64>
必填

图片创建时间,Unix 时间戳,单位为秒。

必填范围: x >= 0
data
object[]
必填

生成结果。该模型每次返回一张图片。

Required array length: 1 element
model
string

实际执行请求的模型标识。

size
string

实际生成尺寸。

Pattern: ^[1-9][0-9]*x[1-9][0-9]*$
output_format
enum<string>

实际输出格式。

可用选项:
png,
jpeg
background
enum<string>

实际使用的背景类型。

可用选项:
opaque,
transparent
usage
object

本次生成的用量信息。