商品图片篡改检测服务

本文介绍商品图片篡改检测服务的API接口。接口可检测图片篡改、质量(清晰度)及相似图。

接口信息

重要

在使用本接口前,请确保已完整阅读接入流程,并开通服务。

  • 接口名:CredentialProductVerifyV2

  • 接口说明:传入电商商品图片,执行图片篡改、质量(清晰度)及相似图检测,返回风险标签及风险分值。

    说明
    1. 本方案主要适用于电商商品图片篡改及质量检测。

    2. 本服务属于AI预测类产品,内部样本准确率是93%,实际准确率由于样本场景的差异可能有波动。

    3. 电子合成图片类图片PS检测难度较大,原生相机拍摄图片检测效果优于电子合成图片。

    4. 检测结果不建议作为凭证真实性判断的唯一方法,可作为辅助审核依据,或作为人工审核提效工具。

  • QPS限量:API独享QPS限量,详情请参见信息核验接口QPS限量说明

  • 服务地址(调用 API 时的 Endpoint):

    地域

    IPv4

    IPv6

    通用

    cloudauth.aliyuncs.com

    cloudauth-dualstack.aliyuncs.com

    北京

    cloudauth.cn-beijing.aliyuncs.com

    cloudauth-dualstack.cn-beijing.aliyuncs.com

    上海

    cloudauth.cn-shanghai.aliyuncs.com

    cloudauth-dualstack.cn-shanghai.aliyuncs.com

    说明
    • 服务地址可选择与业务服务器距离相近的 endpoint ,以降低延迟。

    • 也可以构建列表轮询使用,以提高可用性。

请求参数

参数ImageUrlImageFileObject对应的图片必须符合以下规则:

  • 图片格式:支持PNG、JPG、JPEG、BMPWebP格式。

  • 图片尺寸:图片长宽需要大于15像素,小于8192像素,且长宽比需要小于50。

  • 图片大小:URL格式传入,不能超过10MB;Base64格式传入,不能超过5MB。

  • 为了确保较好的识别效果,建议图像的长宽均大于500像素。

  • 图片过大会影响接口响应速度,建议使用小于 3MB图片。

名称

类型

是否必选

描述

示例值

CredType

String

凭证类型,仅支持取值:05 (商品图片)。

05

CredName

String

凭证名称,仅支持取值:0501(商品图片)。

0501

ProductCode

String

调用模式,仅支持取值:ANTI_FAKE_CHECK

ANTI_FAKE_CHECK

imageUrl

String

图片的地址

重要

imageUrlImageFileObject任选一个。

图⽚的InputStream对象

https://aliyundoc.com/picture*****.jpeg

ImageFileObject

InputStream

MerchantId

String

商户编号

响应参数

名称

类型

描述

示例值

RequestId

String

请求ID

130A2C10-B9EE-4D84-88E3-5384********

Message

String

返回信息

success

Code

String

返回码:200为成功,其他为失败。

重要
  • 此参数代表是否正确调用了接口,详细的返回码说明请参见服务端错误码

  • 业务核验结果请通过ResultObject中的字段查看。

200

ResultObject

Result

String

  • 0:低风险

  • 1:高风险

  • 2:可疑

1

RiskTag

String

风险标签,多个标签用英文逗号隔开,包括:

  • PS:图片PS

  • LOW_QUALITY_PRODUCT:低质量(清晰度低)

  • SAME_BACKGROUND:图片相似

  • LOW_QUALITY_ORIGIN:图片元数据异常

PS,LOW_QUALITY_PRODUCT

RiskScore

Map<String,String>

风险分值。

仅支持PSSAME_BACKGROUND 标签返回分值。

{
  "PS": "0.0211",
  "SAME_BACKGROUND": "0.0861"
}

MaterialInfo

String

其他信息,JSON格式。

{
   "sameBackgroundDetail": {
   // 相似背景对于的原始图请求RequestId
   "originalRequestId": "130A2C10-B9EE-4D84-88E3-5384FF03****";
   // 相似背景对于的原始图请求商户ID 
   "originalMerchantId": "xxxxxxxx" 
   }
}

SDK​调用示例

重要

集成前请确保您已完整阅读接入流程开通了服务获取AccessKey且正确配置环境变量

关于SDK示例和安装包获取:

  • 您可以在OpenAPI的在线接口调试页面的右侧找到对应的SDK调用示例,并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。

    说明

    注意选择所需的编程语言。

    image

  • 如果您有离线安装的需求,可以进入SDK安装页面选择需要语言SDK,并转到发布地址获取。

    image

  • OpenAPI平台可对接口进行在线调试,并获取SDK示例。

  • 代码示例工程各编程语言调用SDK的示例工程,可作为接入参考。