Seedream Pro 图层拆分

将单张图片拆分为底图和可独立编辑的图层

1. 概述

将单张图片拆分为底图和可独立编辑的图层，通过请求顶层的 model 选择已开通的模型。接口同步返回 JSON，不支持流式输出。

模型 ID 模型 输出能力
seedream-4-0-250828 Seedream 4.0 单图 / 组图；固定 JPEG
seedream-4-5-251128 Seedream 4.5 单图 / 组图；固定 JPEG
seedream-5-0-260128 Seedream 5.0 Lite 单图 / 组图；JPEG / PNG
dola-seedream-5-0-pro-260628 Seedream 5.0 Pro 单图 / 图层拆分；JPEG / PNG
  • baseUrl：https://token.soar.qjclouds.cn/laserEr/00000000/v1
  • completionsPath：/image/generations/{apiType}
  • apiType：ImageEdit
  • 标准地址：POST {baseUrl}{completionsPath}
  • 鉴权：Authorization: Bearer <api_key>

请求地址：https://token.soar.qjclouds.cn/laserEr/00000000/v1/image/generations/ImageEdit

2. 鉴权

HTTP 
Authorization: Bearer <api_key>
Content-Type: application/json
Accept: application/json

3. 请求参数

所有参数直接放在 JSON 顶层；prompt 必须是非空字符串。

字段 类型 必填 说明
model string 是 使用上表中当前租户已开通的模型编码。
prompt string 是 图片描述或编辑要求，支持中文和英文。
image string / string[] 条件必填 图生图、编辑和图层拆分时提供参考图 URL 或 Base64 Data URL；可传单图或字符串数组，具体数量、大小、像素和宽高比以所选模型限制为准。
size string 否 模型支持的分辨率档位或宽x高（如 2560x1440），省略使用模型默认值。Pro 普通生图支持 1K、1.5K、2K 或明确宽高；图层拆分仅支持 1K、1.5K、2K、auto，默认 auto。
response_format string 否 url（默认）或 b64_json。
output_format string 否 仅 5.0 Lite / Pro 支持 jpeg、png；4.0 / 4.5 固定输出 JPEG，传入此字段会被拒绝。
watermark boolean 否 是否添加 AI 生成水印。
stream boolean 否 省略或传 false；不支持 true。
sequential_image_generation string 否 仅 4.0 / 4.5 / 5.0 Lite 使用；组图示例为 auto，不使用组图时省略。Pro 禁止传入。
sequential_image_generation_options object 否 与组图开关一起使用，如 {"max_images":3}；可用取值和数量限制以所选模型上游协议为准。Pro 禁止传入。
layer_decomposition boolean 否 仅 Pro 支持；true 开启图层拆分，image 必填且只能有一张。其他模型不要传入此字段。

4. 请求示例

使用图片编辑地址。仅能输入一张图片，返回一张底图和最多 16 个带 alpha 通道的 PNG 图层。任一图层失败则整个请求失败，不支持部分成功。此场景不接受明确的宽x高。

JSON 
{
  "model": "dola-seedream-5-0-pro-260628",
  "prompt": "将图片拆分为底图和可独立编辑的图层",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "size": "auto",
  "response_format": "url"
}

5. 响应

以下为成功响应示例；response_format=url 返回 data[].url，b64_json 返回 data[].b64_json。

JSON 
{
  "created": 1786000000,
  "model": "seedream-4-5-251128",
  "data": [
    {
      "url": "https://example.com/generated-image.jpeg",
      "size": "2560x1440",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1,
    "input_images": 0
  }
}
字段 说明
created 生成时间戳。
model 本次请求使用的客户端模型 ID。
data 成功图片数组；4.0 / 4.5 / Lite 组图可返回多项。Pro 普通生图返回一项，图层拆分返回底图和各图层。
data[].size / output_format 实际输出尺寸和格式，以响应为准。
data[].z_index / name / description 图层拆分时额外返回堆叠顺序（底图为 0）、名称和描述。
data[].bounding_box 图层边界框，含 absolute / normalized 坐标；底图不返回此字段。
usage 上游用量信息，示例含 generated_images、input_images。

图片 URL 有效期由平台和上游服务决定，请及时下载保存。图层尺寸保持对应区域的宽高比，同一次请求中的实际输出尺寸可能不同。

6. 调用提示与错误排查

场景 处理建议
模型不支持 核对 model 编码与租户开通情况。
缺少 prompt 在请求顶层提供非空提示词。
图片无法读取 检查 URL 可访问性、图片格式、大小、数量与像素限制。
stream=true 删除该字段或设为 false。
4.0 / 4.5 传入 output_format 删除 output_format 字段。
Pro 传入组图参数 删除两个 sequential_image_generation* 字段。
图层拆分失败 仅使用 Pro，输入一张 image，size 使用 1K / 1.5K / 2K / auto。
size 无效 使用所选模型支持的档位或符合像素、宽高比限制的宽x高。