跳转到主要内容
POST
cURL
这是 Seedream 图片生成 API 的文生图同步接口。仅通过 prompt 生成图片,不传入任何媒体文件。请求后直接返回生成结果,无需额外查询。

同步接口说明

同步接口请求后直接返回生成结果,无需通过查询接口轮询。以下所有场景均使用同一接口 POST /sd/api/v3/images/generations,仅参数不同:
推荐异步接口:生产环境建议使用异步接口(返回 id,通过查询接口获取结果),支持 webhook 回调通知,更适合大批量生成场景。

授权

TT-API-KEY
string
header
必填

请前往 TTAPI 控制台 获取 API 密钥。

请求体

application/json
model
enum<string>
必填

模型名称。

可用选项:
doubao-seedream-5-0-pro-260628,
doubao-seedream-5-0-flash-260915
prompt
string
必填

文本提示词。

size
enum<string>
默认值:2K

图像尺寸。5.0 pro/flash 可选:1K、1.5K、2K(默认 2K),或指定像素值。

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

输出图像格式。

可用选项:
png,
jpeg
response_format
enum<string>
默认值:url

返回格式。url 返回图片下载链接(24h 有效),b64_json 返回 Base64 编码。

可用选项:
url,
b64_json
background
enum<string>
默认值:opaque

图片透明通道设置。transparent=透明背景(仅图生图场景),opaque=不透明背景。仅 5.0 pro/flash 支持。

可用选项:
transparent,
opaque
watermark
enum<boolean>
默认值:true

是否添加水印。true=右下角显示「AI 生成」,false=不添加。

可用选项:
true,
false
示例:

false

optimize_prompt_options
object

提示词优化配置

响应

200 - application/json

生成成功

model
string
created
integer

创建时间(Unix 时间戳)

data
object[]
usage
object
最后修改于 2026年10月23日