Seedream 图片编辑 - AI 接口对接文档

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. 请求示例

请求地址：POST https://token.soar.qjclouds.cn/laserEr/00000000/v1/image/generations/ImageEdit。参考图可以是单个 URL、单个 Base64 Data URL 或字符串数组。

JSON

{
  "model": "seedream-4-5-251128",
  "prompt": "将参考图中的人物和服装放在统一的城市夜景中，保持人物特征一致",
  "image": [
    "https://example.com/person.png",
    "https://example.com/outfit.png"
  ],
  "size": "2560x1440",
  "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高。