智能出图

适用场景

适用于跨平台铺货场景下的商品图片批量优化，将货源商品图适配为铺货平台需求的主图、SKU 图、详情图，可支持：

• 识别带有文字、水印、Logo、牛皮癣的劣质图片，支持用户过滤需要处理的图片

• 去除原图中的水印、Logo、牛皮癬、中文文案等不合规元素

• 扣除商品主体边缘背景

• 将图片内的文本翻译为其他语言

• 将图片裁剪为指定尺寸

• 将图片像素放大指定倍数

接口

异步接口：通过提交接口拿到 TaskId ，再通过查询接口轮询结果。

提交任务

POST /rest/ai/image/visionflow

查询结果

复用统一异步查询接口，传入提交接口返回的 TaskId 轮询任务状态。详见异步结果查询接口。

POST /rest/ai/task/queryTaskResult

快速开始

import json, time

# 1. 提交任务
submit = make_signed_request("/rest/ai/image/visionflow", json.dumps({
    "ImageUrl": "https://example.com/product.jpg",
    "Ability": [1, 2, 3],
    "NonObjectDetectElements": [1, 2, 3],
    "IsFilter": True,
    "BackGroundType": "WHITE_BACKGROUND",
    "ObjectRemoveElements": [1, 3]
}))
task_id = submit["Data"]["TaskId"]

# 2. 轮询查询
while True:
    time.sleep(5)
    res = make_signed_request("/rest/ai/task/queryTaskResult", json.dumps({"TaskId": task_id}))
    status = res["Data"]["Status"]
    if status in ("COMPLETED", "FAILED"):
        break
print(res["Data"]["Result"]["Result"]["FinalUrl"])

功能介绍

用户输入商品图片 URL，并通过 Ability 参数勾选需要调用的 AI 能力组合，系统将按预设顺序串联执行。其中智能元素识别的结果会影响后续能力的选择——额外提供 IsFilter 参数支持用户按识别结果过滤图片，决定是否进入后续 AI 处理流程。

每项能力对应的编码和说明如下：

效果对比

提交接口

请求参数

下表 17 个字段，按所选能力分组。ImageUrl 和 Ability 为基础必填字段；其余字段的「必填」列标明在启用对应能力（Ability 含该能力编码）时是否必填：是=该能力必填，否=可选，二选一=与同组另一字段至少填一个。未启用对应能力时，该组字段无需传入。

请求示例

{
  "ImageUrl": "https://example.com/product.jpg",
  "Ability": [1, 4, 6],
  "ObjectDetectElements": null,
  "NonobjectDetectElements": [1, 2, 3],
  "IsFilter": true,
  "BackGroundType": "WHITE_BACKGROUND",
  "ObjectRemoveElements": null,
  "NonobjectRemoveElements": [1, 2, 3, 4],
  "Mask": null,
  "SourceLanguage": "zh",
  "TargetLanguage": "en",
  "IncludingProductArea": null,
  "TranslatingBrandInTheProduct": null,
  "Glossary": "glossary_1",
  "TargetWidth": 800,
  "TargetHeight": 600,
  "UpscaleFactor": 2
}

响应参数

查询接口

请求参数

请求示例

{ "TaskId": "75942c08-1d09-942f-bfa9-76703872e668" }

响应参数

响应示例

注意：Data.Result 可能返回 Object 或 JSON 字符串，取决于网关版本。建议始终对 Data.Result 做类型检查后再解析。

返回 Object 形式：

{
  "Data": {
    "Status": "COMPLETED",
    "TaskId": "4a5b8f01-6fa1-95ef-bfd3-89ae8abbb67a",
    "Result": {
      "Result": {
        "ObjLogo": "false",
        "NoobjLogo": "true",
        "ElementStatus": true,
        "NoobjWatermark": "true",
        "FinalUrl": "http://dashscope-7c2c.oss-cn-shanghai.aliyuncs.com/.../result.png?...",
        "ObjCharacter": "false",
        "ObjNpx": "false",
        "SrcUrl": "http://dashscope-7c2c.oss-cn-shanghai.aliyuncs.com/.../input.png?...",
        "ObjWatermark": "false",
        "NoobjCharacter": "true",
        "NoobjNpx": "false"
      }
    }
  },
  "RequestId": "66256E25-2A3E-1A1A-BFAC-0969CA6B0F58",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

返回 JSON 字符串形式（需二次解析）：

{
  "Data": {
    "Status": "COMPLETED",
    "TaskId": "effaf12d-565d-9ae2-8e58-722e977f4ab2",
    "Result": "{\"Result\": {\"ObjNpx\": \"false\", \"SrcUrl\": \"...\", \"FinalUrl\": \"...\", ...}}"
  },
  "RequestId": "3FBCE320-0605-1AF6-8F63-5171A43C1711",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

错误码

智能出图共享统一的命名错误码体系。本能力常触发以下错误码：

• InvalidParameter -- ImageUrl 不合规（分辨率、大小、格式）；或 Ability 选了能力但缺少对应必填参数。

• DownstreamUnavailable -- 图片 URL 无法访问或下游模型暂不可用。

• InputContentBlocked -- 输入图片触发内容安全审核。

• FreeQuotaExhausted -- 试用额度耗尽且未购买商品包。

完整错误码列表，请参见错误码。

翻译支持的语言

仅 Ability=4（图片翻译 Pro）时生效。语言代码采用 ISO 639-1 两位字母；区域变体遵循 RFC 5646 格式（如 zh-tw = 繁体中文）。支持桥接翻译，如 zh→en、en→ar 可实现 zh→en→ar 桥接。

使用限制

• 调用模式：异步。查询接口无 QPS 限制，建议轮询间隔 ≥ 5 秒。提交接口的 QPS 上限详见频率限制。

• 输入图片：分辨率 > 256×256；长边 ≤ 1920 像素；短边 ≤ 1080 像素；大小 ≤ 5 MB；支持 png / jpeg / jpg / bmp / webp。

  智能裁剪输出尺寸：100–5000 像素。

• 高清放大倍数：2–4 倍。

• 计费：按各原子能力的实际调用量计费。详见素材优化计费。

常见问题

后续步骤

• 素材优化 -- 其他 AI 素材优化 API 一览。

• 错误码 -- 完整错误码参考。