跳转到主要内容
使用 seedream-5-5-pro 通过同步图片生成接口创建图片。选择对应标签页,查看文生图、参考图编辑或透明图片输出的请求方式。
生成透明图片时,请将 background 设为 transparent,并将 output_format 设为 png。未设置 background: "transparent" 时,接口返回不透明图片。

创建图片

POST /v1/images/generations
cURL
string
必填
使用 seedream-5-5-pro。
string
必填
图片生成文本提示词。可描述主体、构图、风格、光线、材质和需要呈现的文字。
string
支持 1K、1.5K 和 2K。示例使用 1K,响应返回尺寸为 1248x832。
string
将生成图片作为 URL 或 Base64 数据返回。
string
可使用 png 或 jpeg,两种格式均已接受。需要 Alpha 通道时使用 png。
boolean
是否添加 AI 生成水印。

创建响应

200

请求头

string
必填
Bearer 鉴权,格式为 Bearer YOUR_API_KEY。
string
默认值:"application/json"
必填
请求体格式。

响应字段

string
响应中返回的模型标识。本次请求返回 dola-seedream-5-5-261028。
integer
请求创建时间,Unix 秒级时间戳。
object[]
生成图片列表。
string
response_format 为 url 时返回的临时图片链接。
string
response_format 为 b64_json 时返回的 Base64 数据。
string
生成图片尺寸。
string
生成图片格式。
string
生成图片的背景模式,值为 opaque 或 transparent。
integer
生成图片数量。
integer
适用时返回的输入图片数量。
integer
输出 token 数量。
integer
总 token 数量。

错误响应

错误响应通过 error 对象返回 code、message 和 type 字段。
object
错误信息。
string
可供程序识别的错误码。
string
错误说明。
string
错误类型。
请求无效,或包含不支持的参数值。