通用翻拍检测-电商经营助手-阿里云帮助中心

1、产品简介

基于翻拍识别能力与多模态大模型元素定位构建的通用图片审核产品。产品判断图片是否翻拍，并定位主要实物商品、屏幕显示区、打印照片及可见翻拍线索，适用于多品类门店巡检照片的风险筛查与人工审核。

2、适用场景

巡检照片审核：对门店提交的照片进行翻拍风险筛查。
屏幕或纸质照片复拍核查：定位可见屏幕、打印照片等载体。
审核线索展示：将商品与可见线索标注在原图上，辅助复核。

3、功能介绍

通用翻拍判断：输出 isFake 布尔结论。
审核元素定位：区分实物商品、屏幕、打印照片与可见翻拍线索；屏幕内的商品不重复当作实物商品输出。
线索与结论分开呈现：定位文字只描述可见现象，不把普通反光或正常包装印刷直接作为翻拍证据。

支持单张 HTTPS 图片输入；补充定位最多返回 12 个目标，每个目标包含类别、位置框和最多 24 字的可见文字，并通过 coverage 标明定位是否完整。

4、开发指南

本文请求和响应字段遵循对应搭建文档的实际大小写及结构。示例为业务工作流输入输出，不额外假设平台网关封装；对外调用地址、鉴权方式和网关封装应以实际发布接口为准。

4.1 请求参数

参数名	类型	必填	说明
imageUrl	String	是	待识别原图的 HTTPS 地址；须可访问，不含空白或 URL 用户名密码

4.2 请求示例

{
  "imageUrl": "https://example.com/images/api-03.jpg"
}

示例图片地址和知识库标识（如有）为占位值，调用时替换为实际资源。

4.3 响应参数

通用字段：

字段路径	类型	说明
success	Boolean	调用是否成功；有效业务结论不等于审核通过
errorCode	String	成功为空字符串；失败为错误码
errorMessage	String	成功为空字符串；失败为具体错误说明
result	Object	业务结果；失败时为空对象
usageMap	Object	成功为 {"ProcessingCount":1}；失败为空对象
usageMap.ProcessingCount	Integer	成功处理计数为 1；失败时该字段不返回

业务字段：

字段路径	类型	说明
result.type	String	固定为 general
result.isFake	Boolean	true：翻拍；false：非翻拍

补充定位字段：

字段路径	类型	说明
result.grounding	Object	补充元素定位结果
result.grounding.coverage	String	complete：相关可见目标完整；partial：仅部分目标有效或可辨认
result.grounding.regions	Array	目标数组，最多 12 项；没有相关目标时可为空

| result.grounding.regions[ ].label | String | 目标类别，枚举见下表 |

| result.grounding.regions[ ].bbox_2d | Integer[4] | [左上x,左上y,右下x,右下y]；0–1000；左<右，上<下 |

| result.grounding.regions[ ].text | String | 最多 24 字的可确认短名称或文字；看不清时为空字符串 |

目标类别：

label	含义
product	主要实物商品
screen	屏幕显示区
printed_photo	纸质或打印照片
recapture_cue	可见的疑似翻拍线索

坐标换算：横坐标像素值 = 横坐标 × 原图宽度 / 1000；纵坐标像素值 = 纵坐标 × 原图高度 / 1000。

定位仅有部分结果时可返回 success=true、coverage=partial。发生截断时，仅保留已完整解析的合法目标；删除无效框、去重、截短文字或超出目标数量限制也会标记 partial。合法空 regions 可成功，但不代表前置业务结果也允许为空。若定位服务失败、结果无法恢复或所有框均无效，则整条请求失败。

4.4 响应示例

以下均为结构示例，非实测结果。

1）成功响应

{
  "success": true,
  "errorCode": "",
  "errorMessage": "",
  "result": {
    "type": "general",
    "isFake": false,
    "grounding": {
      "coverage": "complete",
      "regions": [
        {
          "label": "product",
          "bbox_2d": [
            100,
            200,
            300,
            400
          ],
          "text": "商品"
        }
      ]
    }
  },
  "usageMap": {
    "ProcessingCount": 1
  }
}

2）补充定位仅返回部分结果

{
  "success": true,
  "errorCode": "",
  "errorMessage": "",
  "result": {
    "type": "general",
    "isFake": false,
    "grounding": {
      "coverage": "partial",
      "regions": [
        {
          "label": "product",
          "bbox_2d": [
            100,
            200,
            300,
            400
          ],
          "text": ""
        }
      ]
    }
  },
  "usageMap": {
    "ProcessingCount": 1
  }
}

参数错误响应

{
  "success": false,
  "errorCode": "InvalidParameter",
  "errorMessage": "imageUrl 必须为有效的 HTTPS 图片地址",
  "usageMap": {},
  "result": {}
}

处理失败响应

{
  "success": false,
  "errorCode": "DownstreamUnavailable",
  "errorMessage": "未获得有效的元素定位结果",
  "usageMap": {},
  "result": {}
}

4.5 错误码

错误码	含义	处理建议
InvalidParameter	输入不合法或识别服务明确返回业务错误	根据 errorMessage 修正参数或业务输入后重新调用
DownstreamUnavailable	鉴权、限流、超时、空响应、缺字段或解析等处理异常	根据 errorMessage 检查资源与服务状态；临时故障可稍后重试

应结合 success、errorCode、errorMessage 判断结果。源搭建文档未约定每类业务错误对应的 HTTP 状态码。平台公共错误码可参考错误码，本接口工作流错误码以上表为准。