すべてのプロダクト
Search

このプロダクト

    ID Verification:CREDENTIAL_DETECT

    ドキュメントセンター

    ID Verification:CREDENTIAL_DETECT

    最終更新日:Dec 19, 2025

    このトピックでは、認証情報検出 API 操作について説明します。このサービスは、認証情報画像を分析して、偽造、改ざん、画面キャプチャ、再撮影などのリスクを検出します。

    API の説明

    • 操作名： CredentialVerifyIntl

    • 説明： 認証情報画像を分析して、偽造、改ざん、画面キャプチャ、再撮影などのリスクを検出します。

    • リクエストメソッド： POST

    • 転送プロトコル： HTTPS

    • 各 API 操作には、専用の 1 秒あたりのクエリ数 (QPS) 制限が適用されます。詳細については、「ID Verification サーバーサイド API 操作の QPS 制限」をご参照ください。

    • エンドポイント：

      説明

      内部ネットワークは、同一リージョン内の Alibaba Cloud プロダクト間のプライベート通信ネットワークです。ご利用のサービスサーバーがサポート対象の Alibaba Cloud リージョンにデプロイされている場合、VPC エンドポイント経由で ID Verification サービスにアクセスすることで、より安全で安定したネットワーク通信を実現できます。

      シンガポール

      • パブリックエンドポイント： cloudauth-intl.ap-southeast-1.aliyuncs.com

      • VPC エンドポイント： cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    説明

    1. 認証情報検出は AI ベースの予測プロダクトです。Alibaba Cloud の内部テストデータセットでは 90% の精度を達成していますが、実際の精度はシナリオによって異なる場合があります。

    2. デジタル合成画像の編集を検出することはより困難です。このサービスは、デジタル合成画像よりも、ネイティブカメラで撮影された画像に対してより効果的です。

    3. 認証情報の信頼性を検証するために、認証情報検出の結果のみに依存しないでください。レビュープロセスを補完したり、手動レビューをより効率的にしたりするために使用してください。

    4. 認証情報検出は、金融、決済代行、E コマースのマーチャントオンボーディングなど、電子ドキュメントレビューが必要なシナリオで広く使用されています。手動レビューの効率を効果的に向上させます。他のシナリオでの要件がある場合は、アカウントマネージャーにご連絡ください。

    オンラインでのデバッグと統合

    説明

    サーバーサイド API のデバッグと統合を行う前に、「OpenAPI Explorer を使用したサーバーサイド API 操作のデバッグと統合」のドキュメントを読み、API 操作の呼び出し方法と OpenAPI Explorer での SDK およびサンプルコードの取得方法を理解していることを確認してください。

    この操作は OpenAPI Explorer で直接デバッグできます。また、この操作の SDK サンプルコード を生成することもできます。

    リクエストパラメーター

    ImageUrl または ImageFileObject パラメーターで指定された画像は、次の要件を満たす必要があります：

    • 画像フォーマット： PNG、JPG、JPEG、BMP、WebP。

    • 画像ディメンション： 高さおよび幅は 15 ピクセルより大きく、8192 ピクセル未満である必要があります。縦横比は 50 未満である必要があります。

      説明

      最良の検出結果を得るには、高さと幅が両方とも 500 ピクセルより大きい画像を使用してください。

    • 画像サイズ： URL を使用する場合、画像は 10 MB を超えることはできません。ImageFileObject を使用する場合、画像は 3 MB を超えることはできません。

      説明

      画像が大きいと、API の応答時間が増加する可能性があります。3 MB 未満の画像を使用してください。

    名前

    タイプ

    必須

    説明

    例

    CredType

    String

    はい

    認証情報タイプ：

    • 03： ビジネス資格

    • 04： トランザクション認証情報

    03

    CredName

    String

    はい

    認証情報名 (数字コードを使用)：

    • 03 で始まるビジネス資格：

      • 0301： 中国本土の営業許可証

    • 04 で始まるトランザクション認証情報：

      • 0401： 銀行取引明細書

      • 0402： 給与明細

      • 0403： 公共料金請求書

      • 0405： クレジットカード請求書

      • 0499： その他

    説明

    より多くの認証情報タイプをサポートするには、アカウントマネージャーにご連絡ください。

    0301

    ProductCode

    String

    はい

    呼び出しモード：

    • ANTI_FAKE_CHECK： 画像品質と改ざん検出。

    ANTI_FAKE_CHECK

    ImageUrl

    String

    はい

    重要

    imageUrl または ImageFileObject のいずれかを指定してください。

    画像の URL。

    なし

    ImageFileObject

    InputStream

    画像入力ストリーム。

    なし

    レスポンスパラメーター

    名前

    タイプ

    説明

    例

    RequestId

    String

    リクエスト ID。

    130A2C10-B9EE-4D84-88E3-5384********

    Code

    String

    リターンコード。

    重要

    • このパラメーターは、API 操作が正常に呼び出されたかどうかを示します。リターンコードの詳細については、リターンコードのセクションをご参照ください。

    • ビジネス検証結果については、ResultObject のフィールドを確認してください。

    Success

    Message

    String

    リターンコードの詳細な説明。

    success

    ResultObject

    Result

    String

    • 0： 低リスク

    • 1： 高リスク

    • 2： 疑わしい

    1

    RiskTag

    String

    リスクタグ。複数のタグはカンマ (,) で区切られます。有効値：

    • PS： Photoshop 処理された画像

    • SCREEN_PHOTO： 画面の再撮影

    • SCREENSHOT： 画面キャプチャ

    • ORIGINAL_PHOTO： 非オリジナル画像

    PS

    RiskScore

    Map<String,String>

    ヒットしたタグに対してアルゴリズムが予測したリスクスコア。値の範囲は 0 から 1 です。値 1 はリスクが検出されたことを意味し、値 0 はリスクが検出されなかったことを意味します。

    {
  "PS": "0.0211",
  "SCREEN_PHOTO": "0.0101",
  "SCREENSHOT": "0.0521",
  "ORIGINAL_PHOTO": "0.0861"
}

    MaterialInfo

    String

    その他の情報。これは予約済みのフィールドです。

    リターンコード

    HTTP ステータスコード

    コード

    説明

    200

    Success

    リクエストは成功しました。

    400

    MissingParameter

    パラメーターを空にすることはできません。

    400

    Forbidden.ExceptionRepeatedInvoke

    呼び出しが異常に繰り返されました。

    401

    InvalidParameter

    パラメーターが無効です。

    401

    UnqualifiedPhoto

    提供された画像は利用できません。

    401

    ToolargeImage

    提供された画像が大きすぎます。

    401

    DataDuplication

    データが重複しています。

    403

    Forbidden.AccountAccessDenied

    ID Verification を有効化し、アカウントに支払い遅延がないことを確認してください。

    403

    Forbidden.RAMUserAccessDenied

    Resource Access Management (RAM) ユーザーには、AliyunAntCloudAuthFullAccess 権限が必要です。

    500

    Forbidden.ExceptionDataSource

    信頼できるデータソースサービスに異常があります。

    500

    InternalError

    内部システムエラーが発生しました。トラブルシューティングについては、エンジニアにお問い合わせください。