全部产品
Search

搜索本产品

    ID Verification：CREDENTIAL_DETECT

    文档中心

    ID Verification：CREDENTIAL_DETECT

    更新时间：Feb 02, 2026

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

    接口信息

    • 接口名：CredentialVerifyIntl

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

    • 请求方法：POST

    • 传输协议：HTTPS

    • QPS限量：API独享QPS限量，详情请参见ID Verification服务端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文档，充分了解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。

    重要

    • 此参数代表是否正确调用了接口，详细的返回码说明请参见错误码。

    • 业务核验结果请通过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

    其他信息，预留字段。

    返回Code

    HTTP 状态码

    Code

    描述

    200

    Success

    请求成功。

    400

    MissingParameter

    参数不能为空。

    400

    Forbidden.ExceptionRepeatedInvoke

    异常重复调用。

    401

    InvalidParameter

    非法参数。

    401

    UnqualifiedPhoto

    传入图片不可用

    401

    ToolargeImage

    传入图片过大

    401

    DataDuplication

    数据重复

    403

    Forbidden.AccountAccessDenied

    确保您开通了ID verification，并且保证账户未欠费。

    403

    Forbidden.RAMUserAccessDenied

    需要给RAM用户授予 AliyunAntCloudAuthFullAccess 的操作权限。

    500

    Forbidden.ExceptionDataSource

    权威源服务异常。

    500

    InternalError

    系统内部错误，请反馈工程师排查。