すべてのプロダクト
Search

このプロダクト

    ID Verification:FACE_DEEPFAKE

    ドキュメントセンター

    ID Verification:FACE_DEEPFAKE

    最終更新日:Jan 15, 2026

    DeepfakeDetectIntl および DeepfakeDetectIntlStream API 操作は、顔のイメージまたはビデオを分析して、AI 生成顔、ディープフェイク顔交換、テンプレート攻撃、プレゼンテーション攻撃などのリスクを特定します。これらの操作は、リスクタグと信頼度スコアを返します。

    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 操作の呼び出し方法、および OpenAPI Explorer で SDK とサンプルコードを取得する方法をご確認ください。

    イメージとビデオの要件

    説明

    以下のイメージとビデオの要件は、DeepfakeDetectIntlStream と DeepfakeDetectIntl の両方の API 操作に適用されます。

    ディープフェイク検出アルゴリズムは、ビジネス、デバイス、動作などの複数のディメンションからデータを分析します。このアルゴリズムは、顔検出 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 ピクセル (高さ × 幅) です。

    • ビデオフレームレート：8 fps (1 秒あたりのフレーム数) 以上。

    説明

    ビデオの場合、サービスはモデル処理のためにデフォルトで 8 フレームを抽出します。このデフォルトの動作は、Qwen 大規模言語モデル (LLM) に関連するパフォーマンス上の理由によるものです。検出精度を確保するために、無効なビデオを送信しないでください。

    リクエストパラメーター

    名前

    タイプ

    必須

    説明

    例

    ProductCode

    string

    はい

    統合するプロダクト。

    値を FACE_DEEPFAKE に設定します。

    FACE_DEEPFAKE

    SceneCode

    string

    はい

    カスタム認証シナリオ ID。この 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

    顔のイメージまたはビデオのファイルストリーム。

    応答パラメーター

    名前

    タイプ

    説明

    例

    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：プレゼンテーション攻撃の疑い

    SuspectDeepForgery

    RiskScore

    Map

    リスクスコアのマップ。リスクが検出されると、対応するタグが返されます。

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

    リターンコード

    HTTP ステータスコード

    コード

    説明

    200

    Success

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

    400

    MissingParameter

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

    400

    InvalidParameter

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

    401

    NoFaceDetected

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

    401

    UnqualifiedPhoto

    アップロードされたイメージが読み取り不可であるか、解像度が要件を満たしていません。イメージを交換してください。写真が鮮明で、適切に露光され、完全で、隠されておらず、被写体の頭が大きく傾いていないことを確認してください。

    401

    ToolargeImage

    イメージが大きすぎます。イメージを圧縮するか、別のアップロード方法を使用してください。

    401

    DataDuplication

    Base64 またはリンクを使用してイメージを渡すこともできます。

    401

    DownloadTimeout

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

    403

    Forbidden.RAMUserAccessDenied

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

    403

    Forbidden.AccountAccessDenied

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

    403

    Throttling.Api

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

    500

    InternalError

    内部システムエラーが発生しました。テクニカルサポートに連絡して支援を求めてください。