すべてのプロダクト
Search

このプロダクト

    ID Verification:資格証明書検出

    ドキュメントセンター

    ID Verification:資格証明書検出

    最終更新日:Feb 04, 2026

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

    API の説明

    • 操作名：CredentialVerifyIntl

    • 説明：資格証明書のイメージを分析し、偽造、改ざん、画面キャプチャ、再撮影などのリスクを検出します。

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

    • トランスポートプロトコル：HTTPS

    • この API 操作には専用の QPS 制限があります。詳細については、「ID Verification サーバーサイド API 操作の QPS 制限」をご参照ください。

    • エンドポイント：

      説明

      • 内部ネットワークアクセスのメリット：内部ネットワークとは、同一リージョン内の Alibaba Cloud プロダクト間で構築される非公開通信ネットワークです。ビジネスサーバーが対応する Alibaba Cloud リージョンにデプロイされている場合、内部の同一リージョンエンドポイントを使用して ID Verification サービスにアクセスできます。これにより、より安全かつ安定した通信が実現されます。

      • 中国以外からのアクセスに関する最適化の提案：中国以外のネットワーク環境は複雑な場合があります。統合ソリューションを最適化し、ネットワーク遅延を低減するとともに、リクエスト失敗を最小限に抑えるために、「サーバーサイドのネットワーク遅延分析と最適化」をご参照ください。

      シンガポール

      • パブリックネットワーク：cloudauth-intl.ap-southeast-1.aliyuncs.com

      • 内部ネットワーク：cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    説明

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

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

    3. 資格証明書の真正性を検証するために、資格証明書検出の結果のみに依存しないでください。この結果をレビュー処理の補助として活用するか、手動レビューの効率向上に役立ててください。

    4. 資格証明書検出は、金融、支払い取得、E コマース事業者登録など、電子ドキュメントのレビューが必要なシナリオで広く利用されています。これは、手動レビューの効率を大幅に向上させるためです。その他のシナリオでの要件がある場合は、アカウントマネージャーまでご連絡ください。

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

    説明

    API 操作のデバッグおよび統合を行う前に、「OpenAPI Explorer を使用したサーバーサイド API 操作のデバッグと統合」をご参照のうえ、OpenAPI Explorer での API 呼び出し方法や SDK、サンプルコードの取得方法をご確認ください。

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

    リクエストパラメーター

    ImageUrl または ImageFileObject パラメーターで指定されたイメージは、以下の要件を満たす必要があります。

    • イメージフォーマット：PNG、JPG、JPEG、BMP、WebP

    • イメージディメンション：高さおよび幅は 15 ピクセル以上 かつ 8192 ピクセル未満 である必要があります。縦横比は 50 未満 である必要があります。

      説明

      検出結果を最適化するには、高さおよび幅が いずれも 500 ピクセル以上 のイメージを使用してください。

    • イメージサイズ：URL を使用する場合、イメージは 10 MB を超えてはなりません。ImageFileObject を使用する場合、イメージは 3 MB を超えてはなりません。

      説明

      大きなイメージは API の応答時間を増加させる可能性があります。3 MB 未満 のイメージを使用してください。

    Name

    Type

    Required

    Description

    Example

    CredType

    String

    Yes

    資格証明書タイプ：

    • 03：事業資格

    • 04：取引関連証明書

    03

    CredName

    String

    Yes

    資格証明書名（数値コードを使用）：

    • 03 で始まる（事業資格）：

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

    • 04 で始まる（取引関連証明書）：

      • 0401：銀行明細書

      • 0402：給与明細

      • 0403：公共料金請求書

      • 0405：クレジットカード明細

      • 0499：その他

    説明

    より多くの資格証明書タイプをサポートする必要がある場合は、アカウントマネージャーまでご連絡ください。

    0301

    ProductCode

    String

    Yes

    呼び出しモード：

    • ANTI_FAKE_CHECK：イメージ品質および改ざん検出

    ANTI_FAKE_CHECK

    ImageUrl

    String

    Yes

    重要

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

    イメージの URL

    https://example.com/test.jpg

    ImageFileObject

    InputStream

    イメージファイルストリーム

    この方法でイメージをアップロードするには、クラウドプロダクトが提供する Advance 操作を呼び出し、有効な InputStream オブジェクトを渡してください。詳細については、「特殊なシナリオ：ファイルアップロード用の Advance 操作の設定」をご参照ください。

    イメージの InputStream オブジェクト

    レスポンスパラメーター

    Name

    Type

    Description

    Example

    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 ステータスコード

    Code

    Description

    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

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