ID Verification:顔グループへの顔画像の追加

API 情報

• API 名: AddFaceRecord

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

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

• QPS 制限: 単一テナントに対するリクエストレートは 50 QPS に制限されます。

• エンドポイント:

  説明

  • 異なる ID Verification ソリューションは、異なるリージョンをサポートしており、データは各リージョン間で分離されています。ご自身のデータにアクセスするには、データが格納されているリージョンに対応する API ドメイン名を使用する必要があります。

  シンガポール

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

  • 内部エンドポイント: cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

  インドネシア (ジャカルタ)

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

  • 内部エンドポイント: cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

  中国 (香港)

  • パブリックエンドポイント: cloudauth-intl.cn-hongkong.aliyuncs.com

  • 内部エンドポイント: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

  マレーシア (クアラルンプール)

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

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

オンラインデバッグおよび連携

この API を直接実行およびデバッグするには、OpenAPI Explorer を使用します。また、SDK コード例を生成できます。

画像アップロード要件

• 画像形式: JPG、JPEG。

• 画像サイズ: 推奨サイズは 50 KB ～ 100 KB です。最大ファイルサイズは 10 MB です。1 MB を超える画像は、URL またはファイルストリームを使用してアップロードしてください。

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

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

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

リクエストパラメーター

レスポンスパラメーター

{
  "faceQuality": "HIGH"
}