憑證核驗(yàn)服務(wù)
本文介紹憑證核驗(yàn)服務(wù)的API接口。接口可以將傳入的憑證圖片通過大模型進(jìn)行圖片篡改及偽造檢測(cè)、圖片語義理解,來檢測(cè)PS篡改、翻拍、截屏、打印復(fù)印、水印等多種憑證偽造風(fēng)險(xiǎn)。
接口信息
接口名:CredentialVerify
服務(wù)地址:cloudauth.aliyuncs.com(IPv4)或cloudauth-dualstack.aliyuncs.com(IPv6)
接口說明:傳入憑證圖片信息,執(zhí)行圖片篡改及偽造檢測(cè)、圖片語義理解。返回風(fēng)險(xiǎn)檢測(cè)結(jié)果。
QPS限量:API獨(dú)享QPS限量,詳情請(qǐng)參見信息核驗(yàn)接口QPS限量說明。
請(qǐng)求參數(shù)
參數(shù)imageUrl
或imageContext
對(duì)應(yīng)的圖片必須符合以下規(guī)則:
圖片格式:支持PNG、JPG、JPEG、BMP和WebP格式。
圖片尺寸:圖片長寬需要大于15像素,小于8192像素,且長寬比需要小于50。
說明為了確保較好的識(shí)別效果,建議圖像的長寬均大于500像素。
圖片大小:URL格式傳入,不能超過10MB;Base64格式傳入,不能超過1.5MB。
說明圖片過大會(huì)影響接口響應(yīng)速度,建議使用小于 1.5MB圖片。
名稱 | 類型 | 是否必選 | 描述 | 示例值 |
CredType | String | 是 | 憑證類型:
| 02 |
CredName | String | 是 | 憑證名稱(取數(shù)字代碼):
| 0201 |
ProductCode | String | 是 | 調(diào)用模式:
重要 當(dāng)且僅當(dāng)CredType=02時(shí),ProductCode才能為下列取值:
| ANTI_FAKE_CHECK |
imageUrl | String | 是 | 圖片的地址。 重要 imageUrl與imageContext任選一個(gè)。 圖?的Base64編碼。 | 無 |
imageContext | String | 是 | /9j/4AAQSkZJRgABAQAASxxxxxxx | |
PromptModel | String | 否 | 圖片語義理解prompt獲取方式:
重要 當(dāng)ProductCode為下列取值時(shí),此項(xiàng)必選。
| |
Prompt | String | 否 | 圖片語義理解,客戶自定義prompt內(nèi)容。 重要 PromptModel 傳 CUSTOM時(shí),此項(xiàng)必選。 | |
MerchantDetail | String | 否 | 商戶詳細(xì)信息:
重要 PromptModel 傳 DEFAULT時(shí),此項(xiàng)必填。 |
|
MerchantId | String | 否 | 商戶編號(hào)。 重要 CredName為02開頭時(shí),此項(xiàng)必選。 | 無 |
UserName | String | 否 | 姓名。 | 張三 |
IdentifyNum | String | 否 | 身份證號(hào)碼。 | 142702****** |
CertNum | String | 否 | 相關(guān)證書編號(hào)。 | 無 |
響應(yīng)參數(shù)
名稱 | 類型 | 描述 | 示例值 | |
RequestId | String | 請(qǐng)求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 | |
Message | String | 返回信息。 | success | |
Code | String | 返回碼:200為成功,其他為失敗。 重要
| 200 | |
ResultObject | Result | String |
| 1 |
VLResult | String | 圖片理解結(jié)果:
|
| |
RiskTag | String | 風(fēng)險(xiǎn)標(biāo)簽,多個(gè)標(biāo)簽用英文逗號(hào)隔開,包括:
| PS | |
RiskScore | Map<String,String> | 風(fēng)險(xiǎn)分值。 |
| |
MaterialInfo | String | 其他信息,JSON格式。 |
|
SDK?調(diào)用示例
集成前請(qǐng)確認(rèn)您已獲取AccessKey,并已配置環(huán)境變量。具體操作,請(qǐng)參見:
接口在線調(diào)試和SDK示例:OpenAPI平臺(tái)
您可以在OpenAPI的在線接口調(diào)試頁面的右側(cè)找到對(duì)應(yīng)的SDK調(diào)用示例,并在代碼示例的右上角點(diǎn)擊SDK安裝信息查看SDK的安裝信息。
如果您有離線安裝的需求,可以進(jìn)入SDK安裝頁面選擇需要語言的SDK,并轉(zhuǎn)到發(fā)布地址獲取。
各編程語言調(diào)用示例:代碼示例工程