すべてのプロダクト
Search

このプロダクト

    ID Verification:FACE_DEEPFAKE

    ドキュメントセンター

    ID Verification:FACE_DEEPFAKE

    最終更新日:Mar 06, 2026

    DeepfakeDetectIntl および DeepfakeDetectIntlStream API 操作は、入力された顔画像または動画を分析し、AI 生成顔、ディープフェイク顔スワップ、テンプレート攻撃、提示攻撃（Presentation Attack）などのディープフェイクリスクを検出します。応答にはリスクタグと信頼度スコアが含まれます。

    API 情報

    ディープフェイク顔検出サービスは、入力された顔画像または動画を分析して潜在的なディープフェイク脅威を特定します。データ送信方法に応じて、以下の 2 種類の API 操作を提供します。

    DeepfakeDetectIntlStream

    この操作では、画像または動画データをファイルストリームとして直接アップロードできます。ローカルファイルを処理する場合に使用します。

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

    • この 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

    DeepfakeDetectIntl

    この操作では、画像または動画データをパブリック URL または Base64 エンコード文字列として送信します。

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

    • この 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

    オンラインデバッグと連携

    説明

    API 操作のデバッグおよび連携を開始する前に、「OpenAPI Explorer を使用したサーバー側 API 操作のデバッグと連携」を参照し、API 操作の呼び出し方法、SDK およびサンプルコードの取得方法についてご確認ください。

    画像および動画の要件

    説明

    以下の要件は、DeepfakeDetectIntlStream および DeepfakeDetectIntl の両方の操作に適用されます。

    ディープフェイク検出アルゴリズムは、ビジネスコンテキスト、デバイス情報、ユーザー動作など、多様な次元のデータと組み合わせて使用することで、最も高い性能を発揮します。すでに顔検出 SDK を利用している環境で、偽造顔検出機能を強化したい場合に最適です。モデルの安定した性能を確保するため、正面カメラで通常の角度で撮影された顔画像または動画を提出してください。また、以下の要件を満たす必要があります。

    画像

    • フォーマット：JPG または JPEG。

    • サイズ：推奨サイズは 50 KB ～ 100 KB です。最大サイズは 10 MB です。1 MB を超える画像は、URL を使用してアップロードする必要があります。

    • 解像度：推奨解像度は 640 × 480 ピクセル（高さ × 幅）です。最大解像度は 1920 × 1080 ピクセル（高さ × 幅）です。高さは幅より大きい必要があります。画像をスケーリングする場合は、短辺を 720 ピクセルにスケーリングし、圧縮率を 0.8 としてください。

    • 品質：画像は鮮明で、適切な露出である必要があります。顔が暗すぎたり明るすぎたり、ハローが発生したりしないように注意してください。

    • 複数の顔：画像に複数の顔が含まれている場合、システムはデフォルトで最も大きな顔を検出します。

    動画

    • フォーマット：MP4 または MOV。

    • サイズ：動画は 100 KB より大きくなければなりません。最大サイズは 10 MB です。1 MB を超える動画は、URL を使用してアップロードする必要があります。

    • 長さ：1 秒 ～ 3 秒。

    • 解像度：推奨解像度は 640 × 480 ピクセル（高さ × 幅）です。

    • フレームレート：1 秒あたりのフレーム数（fps）が 8 以上。

    説明

    動画の場合、サービスはデフォルトで 8 フレームを抽出して Qwen 大規模言語モデルで処理します。正確な検出を保証するため、無効な動画を提出しないでください。

    リクエストパラメーター

    名前

    型

    必須

    説明

    例

    ProductCode

    string

    はい

    連携するプロダクトを指定します。

    値を FACE_DEEPFAKE に設定します。

    FACE_DEEPFAKE

    SceneCode

    string

    はい

    カスタム認証シナリオの ID です。コンソールで関連レコードを照会するために使用します。

    ID は、英字、数字、アンダースコア（_）を含む 10 文字の文字列である必要があります。

    1234567890

    MerchantBizId

    string

    はい

    加盟店リクエストの固有識別子です。32 文字の英数字文字列である必要があります。

    先頭の数文字は加盟店の略称、中央部にはタイムスタンプを含めることができ、末尾にはランダムまたは増分のシーケンスを配置できます。

    e0c34a77f5ac40a5aa5e6ed20c******

    FaceInputType

    string

    いいえ

    顔素材の入力タイプ：

    • IMAGE（デフォルト）：顔画像。

    • VIDEO：顔動画。

      説明

      動画処理には時間がかかります。タイムアウトを 3 秒以上に設定してください。

    IMAGE

    FaceUrl

    string

    いいえ

    • DeepfakeDetectIntl：データ送信には FaceUrl または FaceBase64 のいずれかを選択します。

    • DeepfakeDetectIntlStream：データ送信には FaceUrl、FaceBase64、FaceFile のいずれかを選択します。

    顔画像または動画の URL。

    https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg

    FaceBase64

    string

    Base64 エンコードされた顔画像です。動画の場合は、URL を使用してアップロードしてください。

    /9j/4AAQSkZJRgABAQAASxxxxxxx

    FaceFile

    string

    顔画像または動画のファイルストリーム。

    応答パラメーター

    説明

    検出モデルが分類用の大規模言語モデルへアップグレードされたため、応答形式が以下のように変更されています。

    • Result フィールドは、値 2（疑わしい）を返さなくなりました。

    • RiskTag フィールドには、SuspectPSFace が含まれなくなりました。

    • RiskScore フィールドがリスクを示す場合、固定値 0.96 を返します。

    名前

    型

    説明

    例

    RequestId

    String

    リクエスト ID。

    8FC3D6AC-9FED-4311-8DA7-C4BF47D9****

    Code

    String

    状態コード。

    Success

    Message

    String

    状態コードの詳細な説明。

    success

    ResultObject

    Result

    String

    リスク判定結果：

    • 0：リスクが低い

    • 1：リスクが高い

    • 2：疑わしい

    1

    RiskTag

    String

    リスクタグです。複数のタグはカンマ（,）で区切られます。タグの一覧は以下のとおりです。

    • SuspectDeepForgery：ディープフェイクの疑いあり

    • SuspectPSFace：合成攻撃の疑いあり

    • SuspectTemple：テンプレート攻撃の疑いあり

    • SuspectRemake：提示攻撃（Presentation Attack）の疑いあり

    SuspectDeepForgery

    RiskScore

    Map

    リスクスコアのマップです。リスク検出時に該当するタグを返します。

    {
 "SuspectPSFace": "0.9796",
 "SuspectRemake": "0.0000",
 "SuspectDeepForgery": "0.9500",
 "SuspectTemple":"0.9500"
 }

    状態コード

    HTTP ステータスコード

    Code

    説明

    200

    Success

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

    400

    MissingParameter

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

    400

    InvalidParameter

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

    401

    NoFaceDetected

    カスタムソース画像内の顔の特徴抽出に失敗しました。別の画像をアップロードしてください。

    401

    UnqualifiedPhoto

    アップロードされた画像が読み取れない、または解像度が要件を満たしていません。画像を差し替えてください。写真は鮮明で、適切な露出、完全な構図、遮蔽なしであり、被写体の頭部に大きな傾きがないことを確認してください。

    401

    ToolargeImage

    画像が大きすぎます。画像を圧縮するか、別のアップロード方法をご利用ください。

    401

    DataDuplication

    Base64 および URL の両方の方法で画像を同時に渡しました。

    401

    DownloadTimeout

    URL からの画像ダウンロードがタイムアウトしました。

    403

    Forbidden.RAMUserAccessDenied

    RAM ユーザーに AliyunAntCloudAuthFullAccess 権限を付与してください。詳細については、「RAM ユーザーにサービスへのアクセス権限を付与する」をご参照ください。

    403

    Forbidden.AccountAccessDenied

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

    403

    Throttling.Api

    API 呼び出しが速度制限によってブロックされました。

    500

    InternalError

    内部システムエラーが発生しました。技術サポートにお問い合わせください。