本文介绍凭证核验服务的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 | 是 | 凭证类型:
| 02 |
CredName | String | 是 | 凭证名称(取数字代码):
| 0201 |
ProductCode | String | 是 | 调用模式:
重要 当且仅当CredType=02时,ProductCode才能为下列取值:
| ANTI_FAKE_CHECK |
imageUrl | String | 是 | 图片的地址。 重要 imageUrl与imageContext任选一个。 图⽚的Base64编码。 | 无 |
imageContext | String | 是 | /9j/4AAQSkZJRgABAQAASxxxxxxx | |
PromptModel | String | 否 | 图片语义理解prompt获取方式:
重要 当ProductCode为下列取值时,此项必选。
| |
Prompt | String | 否 | 图片语义理解,客户自定义prompt内容。 重要 PromptModel 传 CUSTOM时,此项必选。 | |
MerchantDetail | String | 否 | 商户详细信息:
重要 PromptModel 传 DEFAULT时,此项必填。 |
|
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为成功,其他为失败。 重要
| 200 | |
ResultObject | Result | String |
| 1 |
VLResult | String | 图片理解结果:
|
| |
RiskTag | String | 风险标签,多个标签用英文逗号隔开,包括:
| PS | |
RiskScore | Map<String,String> | 风险分值。 |
| |
MaterialInfo | String | 其他信息,JSON格式。 |
|
SDK调用示例
集成前请确认您已获取AccessKey,并已配置环境变量。具体操作,请参见: