跳转到主要内容
POST
cURL
这是 Seedream 图片生成 API 的文生图接口。仅通过 prompt 生成图片,不传入任何媒体文件。提交异步任务后返回 id,需通过查询接口获取结果。

授权

TT-API-KEY
string
header
必填

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

请求体

application/json

文生图请求参数

model
enum<string>
必填

模型名称。

  • doubao-seedream-5-0-pro-260628:专业版
  • doubao-seedream-5-0-flash-260915:快速版
可用选项:
doubao-seedream-5-0-pro-260628,
doubao-seedream-5-0-flash-260915
示例:

"doubao-seedream-5-0-pro-260628"

prompt
string
必填

文本提示词,用于描述生成图像的内容。

size
enum<string>
默认值:2K

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

可用选项:
1K,
1.5K,
2K
示例:

"2K"

output_format
enum<string>
默认值:jpeg

输出图像格式。

可用选项:
png,
jpeg
示例:

"png"

response_format
enum<string>
默认值:url

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

可用选项:
url,
b64_json
示例:

"url"

watermark
enum<boolean>
默认值:true

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

可用选项:
true,
false
示例:

false

optimize_prompt_options
object

提示词优化配置

execution_expires_after
integer
默认值:172800

任务超时阈值(秒)。范围 [3600, 259200](1~72 小时),默认 172800(48 小时)

priority
integer
默认值:0

执行优先级。范围 [0, 9],数值越大优先级越高,默认 0(FIFO)

safety_identifier
string

终端用户唯一标识符,不超过 64 字符。建议传入哈希处理后的字符串

响应

200 - application/json

任务提交成功

status
string
必填

任务状态

示例:

"PENDING_QUEUE"

message
string
必填
示例:

"success"

id
string
必填

任务 ID

示例:

"30d9b07d-7349-4cbc-8e11-9ba302c6d165"

最后修改于 2026年10月23日