跳转到主要内容
POST
cURL
这是 Seedream 图片生成 API 的图层拆分接口。将单张图片拆解为底图(1 张)+ 多个图层输出(最多 16 个图层)。仅 Seedream 5.0 pro / flash 支持。提交异步任务后返回 id,需通过查询接口获取结果。
使用方式:在 prompt 中使用 <bbox> 坐标标注需要拆分的区域,设置 layer_decomposition: true 开启图层拆分模式。

授权

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。

layer_decomposition
enum<boolean>
默认值:false
必填

是否开启图层拆分模式。true=图层拆分,将输入图拆解为底图和多个图层(最多 16 个);false=图片生成模式。仅 Seedream 5.0 pro/flash 支持。

可用选项:
true,
false
size
enum<string>
默认值:auto

图像尺寸。图层拆分场景可选:1K、1.5K、2K、auto(默认 auto,自动保持与输入图一致)。不支持指定像素值。

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

输出图像格式。图层拆分场景下仅控制底图格式,图层始终以 png 输出。

可用选项:
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日