凭证检测服务-实人认证(ID Verification)-阿里云帮助中心

本文介绍凭证检测服务的API接口。该接口基于大模型技术，对传入的凭证图片进行篡改及伪造检测，可识别PS篡改、翻拍、截屏、打印复印及水印等多种伪造风险。

接口信息

重要

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

服务地址（调用 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

说明

重要

信息核验服务暂不支持基于调用次数的硬性封顶或自动停用功能。为有效控制成本并防范高额账单风险，建议在接入产品后及时配置消费告警规则：

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

名称	类型	是否必选	描述	示例值
CredType	String	是	凭证类型： 01：个人卡证类	01
CredName	String	是	凭证名称（取数字代码）： 01开头，个人卡证类： 0101：身份证 0104：教师资格证 0108：中国驾驶证说明由于凭证类型泛化，本文未列举的凭证类型算法均不支持。	0101
ProductCode	String	是	调用模式：ANTI_FAKE_CHECK：图片防伪检测，检测图片真实性。	ANTI_FAKE_CHECK
imageUrl	String	是	imageUrl：图片的地址。 ImageFileObject：图⽚的InputStream对象。 ImageContext：图片Base64编码。重要 imageUrl、ImageFileObject或ImageContext任选一个。	https://aliyundoc.com/picture*****.jpeg
ImageFileObject	InputStream	是		具体接入方式，请参见文件上传 Advance 接口配置。
ImageContext	String	是		iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGA...
MerchantId	String	否	商户编号。重要 CredName为02开头时，此项必选。	无
UserName	String	否	姓名。	张三
IdentifyNum	String	否	身份证号码。	142702******
CertNum	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 SCREEN_PHOTO：屏幕翻拍 SCREENSHOT：屏幕截屏 WATERMARK：水印 SAME_BACKGROUND：背景相似 ORIGINAL_PHOTO：非原始图	PS
	RiskScore	Map<String,String>	风险分值。	`{ "PS": "0.0211", "SCREEN_PHOTO": "0.0101", "SCREENSHOT": "0.0521", "WATERMARK": "0.0001", "SAME_BACKGROUND": "0.0861" }`
	MaterialInfo	String	其他信息，JSON格式。	`{ "sameBackgroundDetail": { // 相似背景对于的原始图请求RequestId "originalRequestId": "130A2C10-B9EE-4D84-88E3-5384FF03****"; // 相似背景对于的原始图请求商户ID "originalMerchantId": "xxxxxxxx" } }`

重要

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

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

您可以在OpenAPI的在线接口调试页面的右侧找到对应的SDK调用示例，并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。
说明
注意选择所需的编程语言。
如果您有离线安装的需求，可以进入SDK安装页面选择需要语言的SDK，并转到发布地址获取。