全部产品
Search

搜索本产品

    ID Verification：CREDENTIAL_DETECT

    文档中心

    ID Verification：CREDENTIAL_DETECT

    更新时间：Jul 07, 2026

    本文介绍凭证检测服务的API接口。传入凭证图片信息，返回是否伪造、篡改，截屏，翻拍等风险。

    接口信息

    • 接口名：CredentialVerifyIntl

    • 接口说明：传入凭证图片信息，返回是否伪造、篡改，截屏，翻拍等风险。

    • 请求方法：POST

    • 传输协议：HTTPS

    • QPS限量：API独享QPS限量，详情请参见服务端API QPS限量说明。

    • 服务地址：

      说明

      • 内网访问优势：内网指阿里云同一地域内各产品间的私有通信网络。若您的业务服务器部署于阿里云对应地域，请使用内网域名访问 ID Verification 服务，以获得更安全、稳定的通信质量。 

      • 海外访问优化建议：海外网络环境复杂，建议参考服务端网络耗时优化，优化集成方案，降低网络延迟及请求失败概率。

      新加坡

      • 公网：cloudauth-intl.ap-southeast-1.aliyuncs.com

      • 内网：cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    说明

    1. 凭证检测属于AI预测类产品，内部测试集样本准确率是90%，实际准确率由于样本场景的差异可能有波动。

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

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

    4. 凭证检测在金融支付收单、电商商家入驻等电子资料审核场景已经得到广泛的运用，有效提升人审效率，如果您有更广泛场景需求，请联系您的商务经理。

    在线调试和集成

    说明

    在调试和集成前，请确保您已完整阅读使用OpenAPI文档，充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

    您可以在OpenAPI Explorer中直接运行本接口进行调试，并生成本接口的SDK代码示例。

    请求参数

    参数ImageUrl或ImageFileObject对应的图片必须符合以下规则：

    • 图片格式：支持PNG、JPG、JPEG、BMP和WebP格式。

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

      说明

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

    • 图片大小：URL格式传入，不能超过10MB；ImageFileObject传入，不能超过3MB。

      说明

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

    名称

    类型

    是否必选

    描述

    示例值

    CredType

    String

    是

    凭证类型：

    • 03：企业资质类

    • 04：交易凭据类

    03

    CredName

    String

    是

    凭证名称（取数字代码）：

    • 03开头，企业资质类：

      • 0301：中国内地工商营业执照

    • 04开头，交易凭据

      • 0401：银行流水

      • 0402：薪资条

      • 0403：水电账单

      • 0405：信用卡账单

      • 0499：其他

    说明

    如果您需要支持更多的凭证类型，请联系您的商务经理。

    0301

    ProductCode

    String

    是

    调用模式：

    • ANTI_FAKE_CHECK：图片质量、篡改检测。

    ANTI_FAKE_CHECK

    ImageUrl

    String

    是

    重要

    imageUrl与ImageFileObject任选一个。

    图片的地址。

    https://example.com/test.jpg

    ImageFileObject

    InputStream

    图片文件流。

    使用此方式上传时，需通过云产品提供的 Advance 接口进行调用，并传入有效的 InputStream 对象。具体实现，请参见特殊场景：文件上传 Advance 接口配置。

    图⽚的InputStream对象

    响应参数

    名称

    类型

    描述

    示例值

    RequestId

    String

    请求ID。

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

    Code

    String

    返回Code，具体信息请参见服务端返回HTTP状态码说明。

    重要

    • 此参数代表是否正确调用了接口。

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

    Success

    Message

    String

    返回Code的详细描述。

    success

    ResultObject

    Result

    String

    • 0：低风险

    • 1：高风险

    • 2：可疑

    1

    RiskTag

    String

    风险标签，多个标签用英文逗号隔开，包括：

    • PS：图片PS

    • SCREEN_PHOTO：屏幕翻拍

    • SCREENSHOT：屏幕截屏

    • ORIGINAL_PHOTO：非原始图

    PS

    RiskScore

    Map<String,String>

    命中标签算法预测风险分值，取值范围为0至1。1表示算法识别到风险，0表示算法未检测到风险。

    {
  "PS": "0.0211",
  "SCREEN_PHOTO": "0.0101",
  "SCREENSHOT": "0.0521",
  "ORIGINAL_PHOTO": "0.0861"
}

    MaterialInfo

    String

    其他信息，预留字段。