图层拆分
把一张图片自动拆成多张带 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 | 包名 | 版本要求 |
|---|---|---|
| Python | tencentcloud-sdk-python / tencentcloud-sdk-python-mps | >= 3.1.188 |
| Go | tencentcloud-sdk-go/tencentcloud/mps | >= v1.3.193 |
| Node.js | tencentcloud-sdk-nodejs-mps | >= 4.1.325 |
| PHP | tencentcloud/tencentcloud-sdk-php | >= 3.0.1681 |
| Java | com.tencentcloudapi:tencentcloud-sdk-java-mps | >= 3.2.40 |
不升级的表现是「字段被静默丢弃」
旧版 SDK 的 models 里没有 AiDecomposeConfig 这个成员,赋值不会报错,但请求序列化时该字段不会被带上——服务端收到的是一个不含拆分配置的普通图片处理请求,于是任务「成功」了却只返回一张图。请先确认版本再排查参数。
完整可运行示例(含任务轮询)见下方「完整调用示例(Python)」。
请求结构
URL 输入 + RMS 输出 + 指定层数 + 额外输出 PSD:
{
"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 会原样作为拆分提示词,写法直接决定拆分效果):
将图片拆分为可编辑的独立图层,并补全被遮挡区域。<点名的主体,用";"分隔>。除以上点名的主体外,其余内容全部保留在 base 图层中,不要再单独分层完整示例(左侧红色汽车、右上角起火木屋、左上角标题文字各占一层,其余留在 base):
"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 字符串:
图层结果
{
"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)
{ "Type": "PSD", "Canvas": { "Width": 1679, "Height": 937 }, "LayerCount": 4 }图层图片的尺寸不一定等于 BoundingBox 的尺寸
使用时把图层图片缩放填满对应 BoundingBox,再按 ZIndex 从小到大叠加到 Canvas 尺寸的画布上,即可还原原图。直接按原始像素尺寸贴图会错位。
业务示例
自动拆层
{
"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
{
"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。
使用自定义提示词
"ImageTask": {
"AiDecomposeConfig": {
"Prompt": "将图片拆分为可编辑的独立图层,并补全被遮挡区域。画面左侧奔跑的红色汽车单独成层;右上角起火的木屋单独成层;左上角的白色标题文字单独成层。除以上点名的主体外,其余内容全部保留在 base 图层中,不要再单独分层"
}
}查询结果(DescribeImageTaskDetail)
请求:
{ "TaskId": "260000****-WorkflowTask-*************" }响应 — 处理中
{
"Response": {
"TaskType": "WorkflowTask",
"Status": "PROCESSING",
"CreateTime": "2026-10-12T02:30:10Z",
"RequestId": "d05d2499-cb25-41a2-b43a-d1e84e898f96"
}
}响应 — 成功(RMS 输出,3 层 + PSD)
{
"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"
}
}响应 — 失败(任务终态)
{
"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 到终态 → 打印每层结果(可选下载签名链接)。
#!/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()运行:
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输出示例:
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 摘要 |
|---|---|---|---|
| 0 | Layer(base,整画布) | ![]() | ZIndex=0,BoundingBox=[0,0,1024,1024] |
| 1 | Layer | ![]() | ZIndex=1,Name=银色竖条纹硬壳行李箱整体,BoundingBox=[258,65,771,1024] |
| 2 | PSD | 2_PSD.psd | LayerCount=2(含 base),画布 1024×1024 |
注意 base 层:原图中被行李箱遮挡的背景已被补全(这是「补全被遮挡区域」的效果),所以它是一张可独立使用的空场景图,而不是一张挖了洞的图。
还原方法:把每层 PNG 缩放填满各自 BoundingBox,按 ZIndex 从小到大叠加到 1024×1024 画布上,即得原图;PSD 用 Photoshop 打开即为同序图层。
计费方案(测试阶段)
临时计费项
计费项为高级图像编辑 AdvancedImageEdit(归属 MPS 图片处理计费族)。后续计费会有更新,该计费项为临时使用。
- 计数规则:每个返回的图层图片计 1 条,每条按该图层图片的实际分辨率计费(不同图层的分辨率可以不同)。
- PSD 文件不计费(
Format=PSD时多出的那 1 个文件不产生费用)。 - 除按图层计费外无其他附加计费项;任务失败(终态失败)不收费。
- 分辨率档位按短边分档(与 MPS 图片处理通用口径一致):
| 档位 | 短边范围 | 高级图像编辑刊例价(元/张) |
|---|---|---|
| 720P | ≤ 720px | 0.1 |
| 1080P | 720px < 短边 ≤ 1080px | 0.2 |
| 2K | 1080px < 短边 ≤ 1440px | 0.4 |
| 4K | 1440px < 短边 ≤ 2160px | 0.8 |
| 8K | 2160px < 短边 ≤ 4320px | 1.6 |
计费示例:1679×937 的输入拆出 base + 2 个主体(共 3 层)+ 1 个 PSD,三层短边均在 720px~1080px 之间(1080P 档):
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 Reference | MPS 鉴权、TC3 签名与请求执行的通用规范 |
| SDK Reference | 用官方 SDK 调用 MPS 关键接口的完整流程 |

