すべてのプロダクト
Search

このプロダクト

    ID Verification:FACE_DEEPFAKE

    ドキュメントセンター

    ID Verification:FACE_DEEPFAKE

    最終更新日:Dec 12, 2025

    ディープフェイク検出 API 操作である DeepfakeDetectIntl および DeepfakeDetectIntlStream は、顔の画像または動画を分析します。これらの操作は、AI によって生成された顔、ディープフェイクによる顔交換、テンプレート攻撃、プレゼンテーション攻撃などのリスクを識別します。操作はリスクタグと信頼度スコアを返します。

    API 情報

    ディープフェイク検出サービスは、顔の画像または動画を分析して、潜在的なディープフェイクのリスクを識別します。このサービスは、さまざまなデータ送信方法をサポートするために、次の 2 つの API 操作を提供します。

    DeepfakeDetectIntlStream

    画像または動画データをファイルストリームとして直接アップロードできます。この方法は、ローカルファイルの処理に適しています。

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

    • 各 API 操作には、専用の QPS (1 秒あたりのクエリ数) 制限が適用されます。詳細については、「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

    DeepfakeDetectIntl

    パブリック URL または Base64 文字列を使用して、画像または動画データを送信できます。

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

    • 各 API 操作には、専用の QPS (1 秒あたりのクエリ数) 制限が適用されます。詳細については、「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

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

    説明

    サーバーサイド API のデバッグと統合を行う前に、必ず「OpenAPI Explorer を使用したサーバーサイド API 操作のデバッグと統合」のドキュメントをお読みになり、OpenAPI Explorer で API 操作を呼び出し、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 秒あたりのフレーム数) 以上。

    説明

    動画の場合、サービスは Qwen 大規模モデルのパフォーマンス上の理由から、デフォルトで 8 フレームを抽出してモデル処理を行います。検出精度を確保するために、無効な動画を送信しないようにしてください。

    リクエストパラメーター

    名前

    タイプ

    必須

    説明

    例

    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

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

    InvalidParameter

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

    TransactionIdInvalid

    無効なトランザクション ID です。

    403

    Forbidden.RAMUserAccessDenied

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

    Forbidden.AccountAccessDenied

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

    Throttling.Api

    スロットリングにより API リクエストがブロックされました。

    404

    ProcessNotCompleted

    認証プロセス全体が完了していません。

    500

    InternalError

    内部システムエラー。トラブルシューティングのためにエンジニアにフィードバックを提供してください。