AI 助理
备案控制台
文档
输入文档关键字查找
首页 实人认证 信息核验 开发参考 凭证防伪 凭证核验服务

凭证核验服务

更新时间：
产品详情
相关技术圈
我的收藏

本文介绍凭证核验服务的API接口。接口可以将传入的凭证图片通过大模型进行图片篡改及伪造检测、图片语义理解，来检测PS篡改、翻拍、截屏、打印复印、水印等多种凭证伪造风险。

接口信息

  • 接口名：CredentialVerify

  • 服务地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）

  • 接口说明：传入凭证图片信息，执行图片篡改及伪造检测、图片语义理解。返回风险检测结果。

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

请求参数

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

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

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

    说明

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

  • 图片大小：图片二进制文件不能超过10 MB。

    说明

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

名称

类型

是否必选

描述

示例值

CredType

String

是

凭证类型：

  • 01：个人卡证类

  • 02：经营场景类

  • 03：企业资质类

02

CredName

String

是

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

  • 01开头，个人卡证类：

    • 0101：身份证

    • 0102：银行卡

    • 0104：教师资格证

    • 0107：学生证

  • 02开头，经营场景类：

    • 0201：门头照

    • 0202：柜台照

    • 0203：场景照

  • 03开头，企业资质类：

    • 0301：工商营业执照

0201

ProductCode

String

是

调用模式：

  • ANTI_FAKE_CHECK：图片防伪检测，检测图片真实性。

  • ANTI_FAKE_VL：图片防伪检测及语义理解，先执行防伪检测，如果检测到风险直接返回结果，如果未检测到风险，执行图片语义理解。

  • IMAGE_VL_COG：图片语义理解，执行图片理解。

重要

当且仅当CredType=02时，ProductCode才能为下列取值：

  • ANTI_FAKE_VL

  • IMAGE_VL_COG

ANTI_FAKE_CHECK

imageUrl

String

是

图片的地址。

重要

imageUrl与imageContext任选一个。

图⽚的Base64编码。

无

imageContext

String

是

/9j/4AAQSkZJRgABAQAASxxxxxxx

PromptModel

String

否

图片语义理解prompt获取方式：

  • DEFAULT：系统默认

  • CUSTOM：客户自定义

重要

当ProductCode为下列取值时，此项必选。

  • ANTI_FAKE_VL

  • IMAGE_VL_COG

Prompt

String

否

图片语义理解，客户自定义prompt内容。

重要

PromptModel 传 CUSTOM时，此项必选。

MerchantDetail

String

否

商户详细信息：

  • MerchantName：商户名称

  • BusinessType：行业信息

  • BusinessContent：经营内容

重要

PromptModel 传 DEFAULT时，此项必填。

[{
    "key":"MerchantName",
    "value":"***"
},{
    "key":"Industry",
    "value":"超市零售"
},{
    "key":"BusinessContent",
    "value":"零售百货"
}]

MerchantId

String

否

商户编号。

重要

CredName为02开头时，此项必选。

无

UserName

String

否

姓名。

张三

IdentifyNum

String

否

身份证号码。

142702******

CertNum

String

否

相关证书编号。

无

响应参数

名称

类型

描述

示例值

RequestId

String

请求ID。

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

Message

String

返回信息。

success

Code

String

返回码：200为成功，其他为失败。

重要

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

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

200

ResultObject

Result

String

  • 0：低风险

  • 1：高风险

  • 2：可疑

1

VLResult

String

图片理解结果：

  • 入参PromptModel 传 DEFAULT时，输出格式参考右侧示例值。

  • 入参PromptModel 传 CUSTOM，输出格式按照Prompt约定格式输出。

{
 "CHK_DOOR_PHOTO":1, -- 是否门头照 1：是 0：否
 "CHK_INTERIOR_PHOTO":0, -- 是否内景照 1：是 0：否
 "CHK_COUNTER_PHOTO":0 -- 是否柜台照 1：是 0：否
}

RiskTag

String

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

  • PS：图片PS

  • SCREEN_PHOTO：屏幕翻拍

  • SCREENSHOT：屏幕截屏

  • WATERMARK：水印

  • COLOR_PRINT：彩打复印

  • SAME_FACE：人脸相似

  • SAME_BACKGROUND：背景相似

  • ORIGINAL_PHOTO：非原始图

PS

RiskScore

Map<String,String>

风险分值。

{
"PS": "0.0211",
"SCREEN_PHOTO": "0.0101",
"SCREENSHOT": "0.0521",
"WATERMARK": "0.0001",
"COLOR_PRINT": "0.0210",
"SAME_FACE": "0.0012",
"SAME_BACKGROUND": "0.0861"
}

MaterialInfo

String

其他信息，JSON格式。

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

SDK​调用示例

重要

集成前请确认您已获取AccessKey，并已配置环境变量。具体操作，请参见：

接口在线调试和SDK示例：OpenAPI平台

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

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

    image

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

    image

上一篇：凭证防伪下一篇：人脸检测
文档推荐