跳转到主要内容
POST
cURL
这是 Seedream 图片生成 API 的交互编辑接口。通过坐标、框选、箭头等方式指定编辑位置,精准编辑图片。仅 Seedream 5.0 pro / flash 支持。提交异步任务后返回 id,需通过查询接口获取结果。
使用方式:在 prompt 中描述编辑意图,可使用坐标、框选、手绘草图等方式指定编辑区域。

授权

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
必填

文本提示词,描述编辑意图,可使用坐标、框选等方式指定编辑区域。

image
string
必填

待编辑的图片 URL。

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,
b64_json
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日