画像入力ガイドライン

なりすまし判定の精度を最大限に引き出すための、入力画像の推奨条件をまとめています。条件を満たさない画像は、判定精度が低下したり、顔が検出できず 400 invalid_image が返ることがあります。

対応フォーマット

画像・顔のサイズ

検出される顔領域の横幅が 80px 以上になるように撮影してください。顔が小さく写っていると検出できないことがあります。フレームサイズを上げれば、より遠くからの撮影でも顔領域のサイズを確保できます。

明るさ

• 顔領域の 平均輝度値 50.0 以上（8bit・256階調）を推奨します。
• 逆光や暗所を避け、顔全体に均等に光が当たる環境で撮影してください。

顔の向き（検出可能な画角）

• 正面を基準に、上下・左右それぞれ ±30° 程度以内を推奨します。
• 顔の形状などにより個人差があります。
• 横顔、大きく傾いた顔、極端なうつむき・見上げは検出できないことがあります。

撮影距離

• カメラから顔までの距離は 30cm〜1m 程度を推奨します。
• 入力画像の解像度を上げれば、より遠くからの撮影にも対応できます（顔の横幅 80px 以上を維持してください）。

カメラで直接撮影する場合の推奨スペック（参考）

エンドユーザーがカメラで撮影してから判定する構成の場合、カメラ側は以下を推奨します。

チェックリスト

判定リクエストを送る前に、入力画像が以下を満たしているか確認してください。

• jpeg または png、10MB 以下
• 可視光カメラのカラー画像（赤外線画像ではない）
• フレームサイズが VGA（640×480）以上
• 顔の横幅が 80px 以上
• 顔が明るく均等に照らされている（平均輝度 50.0 以上）
• 顔の向きが正面から上下左右 ±30° 以内
• 判定したい顔がはっきり写っている

エラーが続く場合は FAQ・トラブルシューティング もご確認ください。