顔写真

登録されたIDに基づく顔認証機能を使用するには、顔写真のアップロードが必要です。写真のアップロードは必須ではありませんが、アップロードされていない場合、各種ソリューションやOpenAPIでの顔認証機能を使用することはできません。

要件

Identity Managerに有効な写真をアップロードするには、写真ファイルが次の基準を満たす必要があります。

項目	最低条件	推奨値
ファイルサイズ	約4MB以下	200KB
顔の最小ピクセル数	32×32	200×200
ファイルフォーマット	JPG（JPEG）、PNG、GIF（最初のフレームのみ）	JPG（JPEG）、PNG
写真に含む顔の数	1つのみ	1

年齢の変化を反映するために、写真を定期的に更新することを推奨します。

品質チェック

品質チェックとは、アップロードされた画像の顔品質に関連する項目のレスポンス値と、それらに対応するしきい値に基づいて、合格かどうかの判断をするプロセスです。その目的は、低品質の顔写真を除外して、顔認証の精度を高めることです。しかし、近年で開発された最先端のサーバー側の顔認証モデルのおかげで、登録写真の品質チェックは以前ほど重要ではなくなりました。アップロードの顔写真に対して、サービス側の基準が厳しすぎると思われる場合は、品質チェックをスキップしても構いません。

以下は、品質チェックで確認する項目と可能なエラーメッセージの一覧です。

項目	OpenAPIメッセージ	ウエブページメッセージ
ヨー	`yaw_too_much`	顔のヨー回転が許容範囲外です。
ピッチ	`pitch_too_much`	顔のピッチ回転が許容範囲外です。
ロール	`roll_too_much`	顔のロール回転が許容範囲外です。
明るさ	`too_bright`	顔が明るすぎます。
明るさ	`too_dark`	顔が暗すぎます。
鋭さ	`too_blur`	顔がぼやけすぎています。
口	`mouth_too_open`	口が開きすぎています。
顔のサイズ	`face_too_big`	顔が大きすぎます。
顔の位置	`face_out_of_frame`	顔の一部が画像外になっています
遮蔽	`overall_too_much_occlusion`	全体的な遮蔽が多すぎます。
遮蔽	`left_eyebrow_too_much_occlusion`	左眉毛の遮蔽が多すぎます。
遮蔽	`right_eyebrow_too_much_occlusion`	右眉毛の遮蔽が多すぎます。
遮蔽	`left_eye_too_much_occlusion`	左目の遮蔽が多すぎます。
遮蔽	`right_eye_too_much_occlusion`	右目の遮蔽が多すぎます。
遮蔽	`nose_too_much_occlusion`	鼻の遮蔽が多すぎます。
遮蔽	`mouth_too_much_occlusion`	口の遮蔽が多すぎます。
遮蔽	`face_contour_too_much_occlusion`	顔の輪郭の遮蔽が多すぎます。
マスク	`cannot_wear_mask`	マスクを着用しないでください。
帽子	`cannot_wear_hat`	帽子をかぶらないでください。
眼鏡	`cannot_wear_sunglasses`	サングラスをかけないでください。
顔の数※	`image_entity_too_many`	画像に複数の顔があります。
顔の数※	`image_entity_not_found`	画像に顔が見当たりません。

※：これらのルールは、品質チェックをスキップしても適用されます。