凭证核验服务

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

接口信息

  • 接口名:CredentialVerify

  • 服务地址:cloudauth.aliyuncs.com(IPv4)或cloudauth-dualstack.aliyuncs.com(IPv6)

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

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

请求参数

参数imageUrlimageContext对应的图片必须符合以下规则:

  • 图片格式:支持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

图片的地址。

重要

imageUrlimageContext任选一个。

图⽚的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

  • 各编程语言调用示例:代码示例工程