Credential Detection Service

API information

• API name: CredentialVerifyV2

• Description: Submits a credential image for tampering, forgery, and returns the risk detection results.

  Note

  1. The Credential Detection Service is an AI-powered predictive product that achieves 90% accuracy on our internal test datasets. Actual accuracy may vary depending on the specific use case and sample images.

  2. Detecting Photoshop alterations in digitally synthesized images is more challenging. The service performs better on images from a native camera than on digitally synthesized images.

  3. Do not use the detection result as the sole basis for determining a credential's authenticity. Use it as a supplementary tool for manual review or to improve review efficiency.

  4. Credential detection only identifies tampering and forgery in images and does not verify whether the type of the submitted image matches the expected type. For optimal detection results, submit images of the correct type.

• QPS limits: This API is subject to dedicated QPS limits. For more information, see QPS Limits for Identity Verification APIs.

• Service endpoint:

  Region	IPv4	IPv6
  common	cloudauth.aliyuncs.com	cloudauth-dualstack.aliyuncs.com
  China (Beijing)	cloudauth.cn-beijing.aliyuncs.com	cloudauth-dualstack.cn-beijing.aliyuncs.com
  China (Shanghai)	cloudauth.cn-shanghai.aliyuncs.com	cloudauth-dualstack.cn-shanghai.aliyuncs.com

  Note

  • To reduce latency, select an endpoint that is geographically close to your servers.

  • You can also create a list of endpoints and poll them in rotation to improve availability.

  Important

  The Information Verification Service does not support a hard cap or automatic deactivation based on the number of calls. To control costs and prevent high bills, we recommend configuring spending alert rules:

  1. Configure spending alerts: Set High-Spending Alert thresholds to monitor your expenses in real time.

  2. Monitor your resource package balance: If you have purchased a resource package, also Set Resource Package Balance Alert. This lets you promptly replenish the package or adjust your call strategy.

  3. Configure business monitoring: See security management to monitor business requests for anomalies and fluctuations.

Request parameters

The image specified in the ImageUrl, ImageFileObject, or ImageContext parameter must meet the following requirements:

• Image format: Supports PNG, JPG, JPEG, BMP, and WebP.

• Image dimensions: Image width and height must be greater than 15 pixels and less than 8,192 pixels. The aspect ratio must be less than 50.

  Note

  For optimal recognition results, we recommend that both the width and height of the image are greater than 500 pixels.

• Image size: The image size limit is 10 MB for URLs and 5 MB for Base64-encoded content.

  Note

  Large images can increase API response time. For best performance, use images smaller than 3 MB.

Response parameters

{
"PS": "0.0211",
"SCREEN_PHOTO": "0.0101",
"SCREENSHOT": "0.0521",
"WATERMARK": "0.0001",
"SAME_BACKGROUND": "0.0861"
}

{
 "sameBackgroundDetail": {
 // Request ID of the original image that has a similar background
 "originalRequestId": "130A2C10-B9EE-4D84-88E3-5384FF03****";
 // Merchant ID from the request for the original image that has a similar background
 "originalMerchantId": "xxxxxxxx" 
 }
}