跳到内容

图层拆分 ​

更新时间

把一张图片自动拆成多张带 alpha 通道的独立图层——相当于把一张平面海报 / 合成图反推成可编辑的分层素材。每一层返回四件东西:

  • 图层图片(PNG,带 alpha)
  • 图层名 Name
  • 堆叠顺序 ZIndex
  • 像素坐标 BoundingBox

可选再额外输出一个 PSD 文件,图层与逐层结果一一对应。

本文的示例口径

全文示例统一使用 URL 输入 + RMS 输出(无需自备 COS 桶,结果以签名链接返回)。实际该能力支持 MPS 图片处理的所有输入与输出形式,换成 COS / AWS-S3 / VOD 只需替换 InputInfo 与 OutputStorage。

接口文档 ​

用途接口官方文档API Explorer
发起图片处理ProcessImage发起图片处理在线调试
查询任务状态DescribeImageTaskDetail查询图片处理任务详情在线调试

SDK 版本(必须先升级) ​

AiDecomposeConfig 为新增字段,低版本 SDK 不包含该字段。下表为支持该字段的最低版本(均为当前最新版本):

SDK包名版本要求
Pythontencentcloud-sdk-python / tencentcloud-sdk-python-mps>= 3.1.188
Gotencentcloud-sdk-go/tencentcloud/mps>= v1.3.193
Node.jstencentcloud-sdk-nodejs-mps>= 4.1.325
PHPtencentcloud/tencentcloud-sdk-php>= 3.0.1681
Javacom.tencentcloudapi:tencentcloud-sdk-java-mps>= 3.2.40

不升级的表现是「字段被静默丢弃」

旧版 SDK 的 models 里没有 AiDecomposeConfig 这个成员,赋值不会报错,但请求序列化时该字段不会被带上——服务端收到的是一个不含拆分配置的普通图片处理请求,于是任务「成功」了却只返回一张图。请先确认版本再排查参数。

完整可运行示例(含任务轮询)见下方「完整调用示例(Python)」。

请求结构 ​

URL 输入 + RMS 输出 + 指定层数 + 额外输出 PSD:

json
{
  "Action": "ProcessImage",
  "InputInfo": {
    "Type": "URL",
    "UrlInputInfo": { "Url": "https://your-bucket-1250000000.cos.ap-guangzhou.myqcloud.com/input/poster.jpg" }
  },
  "OutputStorage": { "Type": "RMS" },
  "ImageTask": {
    "AiDecomposeConfig": {
      "Switch": "ON",
      "Model": "decompose-1.0-flash",
      "Layers": 5,
      "Prompt": ""
    }
  },
  "AddOnParameter": {
    "OutputConfig": { "Format": "PSD" }
  }
}

AiDecomposeConfig ​

参数参数说明取值说明
Switch能力配置开关ON:开启(默认值);OFF:关闭
Model拆分模型目前仅支持 decompose-1.0-flash(默认值,可不传);其它取值返回 InvalidParameter
Layers目标图层数可选,整数,含底图,取值 [2, 17];不传或传 0 表示自动决定层数。是上限引导而非硬约束,实际层数以返回结果为准
Prompt拆分提示词可选。非空时原样作为拆分提示词,Layers 被忽略。服务端不校验长度(超长时任务会失败)

提示词的三种来源(Prompt 优先) ​

请求形态行为
Prompt 非空原样使用:Prompt 作为拆分提示词;Layers 即使传了也忽略
Prompt 为空、Layers 非空按层数引导:按目标层数拆分(底图占 1 层),实际层数可能少于目标值
Prompt 为空、Layers 为空自动拆分:由服务自动决定拆几层(最多 17 层)

自定义 Prompt 的推荐写法(Prompt 会原样作为拆分提示词,写法直接决定拆分效果):

text
将图片拆分为可编辑的独立图层,并补全被遮挡区域。<点名的主体,用";"分隔>。除以上点名的主体外,其余内容全部保留在 base 图层中,不要再单独分层

完整示例(左侧红色汽车、右上角起火木屋、左上角标题文字各占一层,其余留在 base):

json
"ImageTask": {
  "AiDecomposeConfig": {
    "Prompt": "将图片拆分为可编辑的独立图层,并补全被遮挡区域。画面左侧奔跑的红色汽车;右上角起火的木屋;左上角的白色标题文字。除以上点名的主体外,其余内容全部保留在 base 图层中,不要再单独分层"
  }
}

为什么要写「其余内容全部保留在 base 图层中」

不写这句时,模型会把画面里它认为显著的其它元素也拆出来,层数不可控、计费也跟着涨(按层计费)。点名主体 + 明确兜底,是把拆分结果收敛到可预期范围的关键。

输入 InputInfo ​

  • 主输入必填(待拆分的图片),支持 URL / COS / AWS-S3 / VOD;本文示例使用 URL(http/https 直链,服务端拉取)。
  • 输入尺寸沿用 MPS 图片处理通用限制(单边 ≤ 10240)。

输出容器 AddOnParameter.OutputConfig.Format ​

取值输出
不传 / PNG(默认)只输出逐层 PNG(带 alpha)
PSD逐层 PNG 之外再多输出 1 个 PSD:画布 = 返回的画布尺寸,PSD 图层与逐层结果一一对应(同名、同序、同位置)

其它取值(含 JPEG / WEBP 等)返回 InvalidParameter——图层必须保留 alpha。Quality / AspectRatio / ImageSize / ImageWidth / ImageHeight 对本能力不生效。

输出存储 OutputStorage:RMS 模式 ​

OutputStorage 与 ImageTask 同级:

参数参数说明取值说明
Type输出存储类型本文示例用 RMS(MPS 托管存储):无需传桶 / 地域,服务端分配输出位置,结果以签名链接返回;也支持 COS / AWS-S3 / VOD(与其他图片能力一致)

URL 输入时 OutputStorage 必填

URL 无法推导输出位置,不传会返回 InvalidParameter。COS / AWS-S3 / VOD 输入时可省略,继承输入位置。

输出结果 ​

DescribeImageTaskDetail.ImageProcessTaskResultSet 按从底到顶的顺序列出每一层(ZIndex 0、1、2…),Format=PSD 时最后再追加 1 条 PSD 结果。每条结果的 Output.Content 是一个 JSON 字符串:

图层结果 ​

json
{
  "Type": "Layer",
  "Name": "画面中央奔跑的男性人物",
  "ZIndex": 2,
  "BoundingBox": [612, 140, 1180, 920],
  "Canvas": { "Width": 1679, "Height": 937 }
}
字段说明
Type固定 Layer
Name图层名。与 PSD 中对应图层的名称完全一致;无法命名时为 layer_{ZIndex}
ZIndex堆叠顺序,从 0(底图 base)开始连续编号,越大越靠上
BoundingBox[X1, Y1, X2, Y2],像素坐标,原点为画布左上角,落在画布内
Canvas画布尺寸(像素)。底图 base 层的 BoundingBox 恒为 [0, 0, Width, Height]

PSD 结果(仅 Format=PSD) ​

json
{ "Type": "PSD", "Canvas": { "Width": 1679, "Height": 937 }, "LayerCount": 4 }

图层图片的尺寸不一定等于 BoundingBox 的尺寸

使用时把图层图片缩放填满对应 BoundingBox,再按 ZIndex 从小到大叠加到 Canvas 尺寸的画布上,即可还原原图。直接按原始像素尺寸贴图会错位。

业务示例 ​

自动拆层 ​

json
{
  "Action": "ProcessImage",
  "InputInfo": {
    "Type": "URL",
    "UrlInputInfo": { "Url": "https://your-bucket-1250000000.cos.ap-guangzhou.myqcloud.com/input/poster.jpg" }
  },
  "OutputStorage": { "Type": "RMS" },
  "ImageTask": { "AiDecomposeConfig": { "Model": "decompose-1.0-flash" } }
}

指定层数 + 输出 PSD ​

json
{
  "Action": "ProcessImage",
  "InputInfo": {
    "Type": "URL",
    "UrlInputInfo": { "Url": "https://your-bucket-1250000000.cos.ap-guangzhou.myqcloud.com/input/poster.jpg" }
  },
  "OutputStorage": { "Type": "RMS" },
  "ImageTask": {
    "AiDecomposeConfig": { "Layers": 4 }
  },
  "AddOnParameter": { "OutputConfig": { "Format": "PSD" } }
}

按目标 4 层(base + 3)引导拆分,期望输出至多 4 个图层 + 1 个 PSD。

使用自定义提示词 ​

json
"ImageTask": {
  "AiDecomposeConfig": {
    "Prompt": "将图片拆分为可编辑的独立图层,并补全被遮挡区域。画面左侧奔跑的红色汽车单独成层;右上角起火的木屋单独成层;左上角的白色标题文字单独成层。除以上点名的主体外,其余内容全部保留在 base 图层中,不要再单独分层"
  }
}

查询结果(DescribeImageTaskDetail) ​

请求:

json
{ "TaskId": "260000****-WorkflowTask-*************" }

响应 — 处理中 ​

json
{
  "Response": {
    "TaskType": "WorkflowTask",
    "Status": "PROCESSING",
    "CreateTime": "2026-10-12T02:30:10Z",
    "RequestId": "d05d2499-cb25-41a2-b43a-d1e84e898f96"
  }
}

响应 — 成功(RMS 输出,3 层 + PSD) ​

json
{
  "Response": {
    "TaskType": "WorkflowTask",
    "Status": "FINISH",
    "CreateTime": "2026-10-12T02:30:10Z",
    "FinishTime": "2026-10-12T02:30:42Z",
    "ImageProcessTaskResultSet": [
      {
        "Status": "SUCCESS",
        "Output": {
          "Path": "share/1250000000/20261012/3f2b1c9e-8a4d-4c7b-9f01-2d5e6a7b8c90.png",
          "SignedUrl": "https://beauty-1378942524.cos.ap-shanghai.myqcloud.com/share/1250000000/20261012/3f2b1c9e-….png?q-sign-algorithm=sha1&q-ak=…&q-signature=…",
          "Content": "{\"Type\":\"Layer\",\"Name\":\"base\",\"ZIndex\":0,\"BoundingBox\":[0,0,1679,937],\"Canvas\":{\"Width\":1679,\"Height\":937}}"
        }
      },
      {
        "Status": "SUCCESS",
        "Output": {
          "Path": "share/1250000000/20261012/a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d.png",
          "SignedUrl": "https://beauty-1378942524.cos.ap-shanghai.myqcloud.com/share/1250000000/20261012/a1b2c3d4-….png?q-sign-algorithm=sha1&…",
          "Content": "{\"Type\":\"Layer\",\"Name\":\"画面中央奔跑的男性人物\",\"ZIndex\":1,\"BoundingBox\":[612,140,1180,920],\"Canvas\":{\"Width\":1679,\"Height\":937}}"
        }
      },
      {
        "Status": "SUCCESS",
        "Output": {
          "Path": "share/1250000000/20261012/b2c3d4e5-6f7a-4b8c-9d0e-1f2a3b4c5d6e.png",
          "SignedUrl": "https://beauty-1378942524.cos.ap-shanghai.myqcloud.com/share/1250000000/20261012/b2c3d4e5-….png?q-sign-algorithm=sha1&…",
          "Content": "{\"Type\":\"Layer\",\"Name\":\"右上角起火的木屋\",\"ZIndex\":2,\"BoundingBox\":[1180,120,1620,560],\"Canvas\":{\"Width\":1679,\"Height\":937}}"
        }
      },
      {
        "Status": "SUCCESS",
        "Output": {
          "Path": "share/1250000000/20261012/c3d4e5f6-7a8b-4c9d-0e1f-2a3b4c5d6e7f.psd",
          "SignedUrl": "https://beauty-1378942524.cos.ap-shanghai.myqcloud.com/share/1250000000/20261012/c3d4e5f6-….psd?q-sign-algorithm=sha1&…",
          "Content": "{\"Type\":\"PSD\",\"Canvas\":{\"Width\":1679,\"Height\":937},\"LayerCount\":3}"
        }
      }
    ],
    "RequestId": "bf13665d-843a-45f2-a297-97e9ef26966a"
  }
}

响应 — 失败(任务终态) ​

json
{
  "Response": {
    "TaskType": "WorkflowTask",
    "Status": "FINISH",
    "ErrMsg": "ContentBlocked",
    "CreateTime": "2026-10-12T02:30:10Z",
    "FinishTime": "2026-10-12T02:30:18Z",
    "RequestId": "bf13665d-843a-45f2-a297-97e9ef26966a"
  }
}

两件容易写错的事

① 不要依赖文件名对应图层。 结果顺序即图层顺序(自底向上,ZIndex 递增),PSD 永远是最后一条;请用 Content 里的 ZIndex / Name 对应图层。(COS 输出时默认文件名为 {输入文件名}_layer_{ZIndex}.png / {输入文件名}.psd,RMS 输出则是服务端 uuid 文件名。)

② 失败时任务同样是终态。 Status=FINISH、无结果集,失败原因读 Response.ErrMsg——不要把「没有 ImageProcessTaskResultSet」当成还在处理而继续轮询。提交阶段的参数校验失败不走任务查询,直接同步返回 InvalidParameter 错误。

完整调用示例(Python) ​

依赖 tencentcloud-sdk-python >= 3.1.188。脚本做三件事:发起 ProcessImage(URL 输入 + RMS 输出)→ 轮询 DescribeImageTaskDetail 到终态 → 打印每层结果(可选下载签名链接)。

python
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""图层拆分(AiDecomposeConfig)调用示例:URL 输入 + RMS 输出,SDK 模型方式发起 ProcessImage 并轮询到终态。"""

import argparse
import json
import sys
import time
import urllib.request

from tencentcloud.common import credential
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.mps.v20190612 import models, mps_client

ENDPOINT = "mps.tencentcloudapi.com"


def parse_args():
    parser = argparse.ArgumentParser(description="MPS 图片图层拆分调用示例")
    parser.add_argument("--secret-id", required=True, help="腾讯云 API 密钥 SecretId")
    parser.add_argument("--secret-key", required=True, help="腾讯云 API 密钥 SecretKey")
    parser.add_argument("--image-url", required=True, help="待拆分图片的可公网访问 URL")
    parser.add_argument("--layers", type=int, default=0, help="目标图层数 [2,17](含 base);0=自动")
    parser.add_argument("--prompt", default="", help="自定义拆分提示词;非空时原样使用并忽略 --layers")
    parser.add_argument("--psd", action="store_true", help="额外输出 1 个 PSD 文件")
    parser.add_argument("--region", default="ap-guangzhou", help="接口地域")
    parser.add_argument("--timeout", type=int, default=600, help="轮询最长等待秒数")
    parser.add_argument("--interval", type=float, default=3, help="轮询间隔秒数")
    parser.add_argument("--download-dir", default=None, help="可选:把结果下载到该目录")
    return parser.parse_args()


def build_request(args):
    decompose = models.AiDecomposeConfig()
    if args.layers:
        decompose.Layers = args.layers
    if args.prompt:
        decompose.Prompt = args.prompt

    image_task = models.ImageTaskInput()
    image_task.AiDecomposeConfig = decompose

    url_input = models.UrlInputInfo()
    url_input.Url = args.image_url
    input_info = models.MediaInputInfo()
    input_info.Type = "URL"
    input_info.UrlInputInfo = url_input

    # RMS(MPS 托管存储):只需指定 Type,无需桶/地域;结果以签名链接返回
    output_storage = models.TaskOutputStorage()
    output_storage.Type = "RMS"

    req = models.ProcessImageRequest()
    req.InputInfo = input_info
    req.OutputStorage = output_storage
    req.ImageTask = image_task

    if args.psd:
        output_config = models.ImageProcessOutputConfig()
        output_config.Format = "PSD"
        add_on = models.AddOnParameter()
        add_on.OutputConfig = output_config
        req.AddOnParameter = add_on
    return req


def fetch_results(detail, download_dir):
    for i, item in enumerate(detail.ImageProcessTaskResultSet or []):
        output = item.Output
        if output is None:
            continue
        content = {}
        if output.Content:
            try:
                content = json.loads(output.Content)
            except ValueError:
                content = {"raw": output.Content}
        if content.get("Type") == "Layer":
            print("  [{}] Layer ZIndex={} Name={} BoundingBox={} Canvas={}x{}".format(
                i, content.get("ZIndex"), content.get("Name"), content.get("BoundingBox"),
                (content.get("Canvas") or {}).get("Width"), (content.get("Canvas") or {}).get("Height")))
        else:
            print("  [{}] {} {}".format(i, content.get("Type"), json.dumps(content, ensure_ascii=False)))
        print("        Path={}".format(output.Path))
        if output.SignedUrl:
            print("        SignedUrl={}".format(output.SignedUrl[:120] + "..."))
            if download_dir:
                name = "{}_{}".format(i, content.get("ZIndex", content.get("Type", "out")))
                ext = ".psd" if content.get("Type") == "PSD" else ".png"
                dst = "{}/{}{}".format(download_dir.rstrip("/"), name, ext)
                urllib.request.urlretrieve(output.SignedUrl, dst)
                print("        saved -> {}".format(dst))


def main():
    args = parse_args()

    http_profile = HttpProfile()
    http_profile.endpoint = ENDPOINT
    profile = ClientProfile()
    profile.httpProfile = http_profile
    client = mps_client.MpsClient(credential.Credential(args.secret_id, args.secret_key),
                                  args.region, profile)

    try:
        resp = client.ProcessImage(build_request(args))
    except TencentCloudSDKException as e:
        raise SystemExit("[ProcessImage] 调用失败: {}".format(e))
    print("TaskId:", resp.TaskId)

    start = time.time()
    last_status = None
    while True:
        detail_req = models.DescribeImageTaskDetailRequest()
        detail_req.TaskId = resp.TaskId
        try:
            detail = client.DescribeImageTaskDetail(detail_req)
        except TencentCloudSDKException as e:
            raise SystemExit("[DescribeImageTaskDetail] 调用失败: {}".format(e))
        if detail.Status != last_status:
            print("status: {} ({:.1f}s)".format(detail.Status, time.time() - start))
            last_status = detail.Status
        if detail.Status == "FINISH":
            break
        if time.time() - start > args.timeout:
            raise SystemExit("轮询超时({}s),最后状态: {}".format(args.timeout, detail.Status))
        time.sleep(args.interval)

    print("任务终态:Status={},耗时 {:.1f}s".format(detail.Status, time.time() - start))
    if detail.ErrMsg:
        print("任务失败: {} {}".format(detail.ErrMsg, detail.Message or ""))
        sys.exit(1)
    fetch_results(detail, args.download_dir)


if __name__ == "__main__":
    main()

运行:

bash
pip install -U "tencentcloud-sdk-python>=3.1.188"
python3 call_decompose.py --secret-id <SecretId> --secret-key <SecretKey> \
    --image-url https://your-bucket-1250000000.cos.ap-guangzhou.myqcloud.com/input/poster.jpg \
    --layers 4 --psd --download-dir ./out

输出示例:

text
TaskId: 260000******-WorkflowTask-******************
status: WAITING (0.3s)
status: PROCESSING (2.1s)
status: FINISH (38.6s)
任务终态:Status=FINISH,耗时 38.6s
  [0] Layer ZIndex=0 Name=base BoundingBox=[0, 0, 1679, 937] Canvas=1679x937
        Path=share/1250000000/20261012/3f2b1c9e-8a4d-4c7b-9f01-2d5e6a7b8c90.png
        SignedUrl=https://beauty-1378942524.cos.ap-shanghai.myqcloud.com/share/1250000000/20261012/3f2b1c9e-...
        saved -> ./out/0_0.png
  [1] Layer ZIndex=1 Name=画面中央奔跑的男性人物 BoundingBox=[612, 140, 1180, 920] Canvas=1679x937
        Path=share/1250000000/20261012/a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d.png
        SignedUrl=https://beauty-1378942524.cos.ap-shanghai.myqcloud.com/share/1250000000/20261012/a1b2c3d4-...
        saved -> ./out/1_1.png
  [2] Layer ZIndex=2 Name=右上角起火的木屋 BoundingBox=[1180, 120, 1620, 560] Canvas=1679x937
        Path=share/1250000000/20261012/b2c3d4e5-6f7a-4b8c-9d0e-1f2a3b4c5d6e.png
        SignedUrl=https://beauty-1378942524.cos.ap-shanghai.myqcloud.com/share/1250000000/20261012/b2c3d4e5-...
        saved -> ./out/2_2.png
  [3] PSD {"Type": "PSD", "Canvas": {"Width": 1679, "Height": 937}, "LayerCount": 3}
        Path=share/1250000000/20261012/c3d4e5f6-7a8b-4c9d-0e1f-2a3b4c5d6e7f.psd
        SignedUrl=https://beauty-1378942524.cos.ap-shanghai.myqcloud.com/share/1250000000/20261012/c3d4e5f6-...
        saved -> ./out/3_PSD.psd

输入 / 输出示例 ​

输入:一张 1024×1024 的银色行李箱产品图(URL 直链,示例 https://your-bucket-1250000000.cos.ap-guangzhou.myqcloud.com/input/suitcase.png)。

输出(请求 Switch=ON、Format=PSD;本例自动拆分实际返回 2 层 + 1 个 PSD):

序号类型文件Content 摘要
0Layer(base,整画布)base 图层:补全后的空场景ZIndex=0,BoundingBox=[0,0,1024,1024]
1LayerZIndex=1 图层:透明底的银色行李箱ZIndex=1,Name=银色竖条纹硬壳行李箱整体,BoundingBox=[258,65,771,1024]
2PSD2_PSD.psdLayerCount=2(含 base),画布 1024×1024

注意 base 层:原图中被行李箱遮挡的背景已被补全(这是「补全被遮挡区域」的效果),所以它是一张可独立使用的空场景图,而不是一张挖了洞的图。

还原方法:把每层 PNG 缩放填满各自 BoundingBox,按 ZIndex 从小到大叠加到 1024×1024 画布上,即得原图;PSD 用 Photoshop 打开即为同序图层。

计费方案(测试阶段) ​

临时计费项

计费项为高级图像编辑 AdvancedImageEdit(归属 MPS 图片处理计费族)。后续计费会有更新,该计费项为临时使用。

  • 计数规则:每个返回的图层图片计 1 条,每条按该图层图片的实际分辨率计费(不同图层的分辨率可以不同)。
  • PSD 文件不计费(Format=PSD 时多出的那 1 个文件不产生费用)。
  • 除按图层计费外无其他附加计费项;任务失败(终态失败)不收费。
  • 分辨率档位按短边分档(与 MPS 图片处理通用口径一致):
档位短边范围高级图像编辑刊例价(元/张)
720P≤ 720px0.1
1080P720px < 短边 ≤ 1080px0.2
2K1080px < 短边 ≤ 1440px0.4
4K1440px < 短边 ≤ 2160px0.8
8K2160px < 短边 ≤ 4320px1.6

计费示例:1679×937 的输入拆出 base + 2 个主体(共 3 层)+ 1 个 PSD,三层短边均在 720px~1080px 之间(1080P 档):

text
3 层 × 0.2 元(1080P 档) = 0.6 元;PSD 文件不计费

层数以实际返回为准;用量与账单在控制台「MPS 图片处理」计费项下查看。

层数直接决定成本

因为按层计费,Layers 与 Prompt 的写法不只影响效果、也影响账单。需要成本可控时,用自定义 Prompt 点名主体 + 明确「其余留在 base」,比不加约束的自动拆分更可预期。

使用限制 ​

项限制
主 InputInfo必填(待拆分的图片),支持 URL / COS / AWS-S3 / VOD;URL 输入时 OutputStorage 必填
与其他能力组合不支持:ImageTask 只能带 AiDecomposeConfig,不能带 ScheduleId;Switch=OFF 时按普通请求处理
输入尺寸与 MPS 图片处理通用限制一致(单边 ≤ 10240)
Layers整数,[2, 17](含 base);不传 / 0 = 自动
Prompt不校验长度;超长时任务会失败
输出格式PNG(默认)或 PSD
输出层数由服务根据图片内容决定,最多 17 层(含 base);Layers 仅作引导
输出文件名COS / VOD 输出:图层 {输入文件名}_layer_{ZIndex}.png、PSD {输入文件名}.psd;RMS 输出为服务端 uuid 文件名,用 Content 对应图层

常见错误码 ​

错误码含义典型原因
InvalidParameter参数不合法Model / Switch 取值不支持;Layers 不在 [2, 17](且非 0);OutputConfig.Format 不是 PNG / PSD;缺少主 InputInfo;URL 输入未传 OutputStorage;与其它能力组合
InvalidInput输入获取失败输入图 URL 不可访问 / COS 对象不存在
InputSizeExceeded输入尺寸超出限制单边超过 10240
UnsupportedMediaType输入无法解码损坏或非图片文件
ContentBlocked内容安全审核未通过输入或输出内容未通过审核
TooManyRequests请求过于频繁短时间内提交过多,请降低频率后重试
InternalError服务内部错误图片无法完成拆分(含 Prompt 超长);任务直接结束,不会自动重试
ServiceUnavailable服务暂不可用请稍后重新提交

相关文档 ​

文档说明
API ReferenceMPS 鉴权、TC3 签名与请求执行的通用规范
SDK Reference用官方 SDK 调用 MPS 关键接口的完整流程

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages