5 顔検知クイックスタートガイド
Mercury Cloudの顔検出機能を素早く着手するためのガイドが提供されています。
顔検知APIは画像内の顔を検出し、顔枠を外接する長方形の座標を返します。同APIでは、顔の角度、性別、年齢、感情など、顔に関連するいくつかの属性も抽出できます。すべての属性は実際の分類ではなく、AIアルゴリズムによる予測によるものです。
以下の手順では1枚の画像をアップロードし、画像内の顔を検出する方法を記載しています。正常に検出された場合、検出された顔情報が返されます。
5.1 準備
まず、Python環境がインストールされていることを確認してください。次に、下記のPythonファイルをダウンロードしてPythonのパスフォルダーにコピーしてください。
api_parameters.pyをテキストエディターで開き、パラメーターをお客様の情報に置き換えてください。詳細は3.2節をご参照ください。
api_parameters.pyをテキストエディターで開き、パラメーターをお客様の情報に置き換えてください。詳細は3.2節をご参照ください。
5.2 顔検知リクエスト送信
次のコマンドを使うことで、顔検出のAPIリクエストを送信し、その画像内の顔を検出することができます。パスは、Pythonライブラリパスと画像ファイルのパスにそれぞれ置き換えてください。
結果は次のようになります。顔が検出されたかどうかを示す検出resultsフィールドに、検出された顔の詳細が含まれています。
ここでのHAT_STYLE_TYPE_NONEは、検出された顔に帽子/キャップが着用されていないことを意味します。TRANSPARENT_GLASSESは、検出された顔に通常の眼鏡（サングラスではない）を着用されていないことを意味します。COLOR_TYPE_NONEは、検出された顔にマスクが着用されていないことを意味します。
詳細は、2章で提供されている最新バージョンのYAMLファイルまたはオンラインAPIマニュアルを参照してください。
表：属性
項目
説明
値の意味
age_lower_limit
推定年齢下限
-
age_up_limit
推定年齢上限
-
st_age
推定年齢分類
ST_CHILD：子供ST_ADULT：大人ST_OLD：お年寄り
gender_code
推定性別分類
MALE：男性FEMALE：女性
mustache_style
推定ひげ分類
MUSTACHE_STYLE_TYPE_NONE：ひげ無WHISKERS：ひげ有
respirator_color
推定マスク着用状態
COLOR_TYPE_NONE：マスク着用無COLOR_TYPE_OTHER：マスク着用有
glass_style
推定メガネ着用状態
GLASSES_STYLE_TYPE_NONE：メガネ着用無TRANSPARENT_GLASSES：通常のメガネ着用有SUNGLASSES：サングラス着用有
cap_style
推定帽子（キャップ）着用状態
HAT_STYLE_TYPE_NONE：キャップ着用無CAP：キャップ着用有
st_helmet_style
推定ヘルメット着用状態
ST_HELMET_STYLE_TYPE_NONE：ヘルメット着用無ST_HELMET：ヘルメット着用有
st_expression
推定表情分類
ST_CALM：冷静ST_HAPPY：喜びST_ANGRY：怒りST_SURPRISED：驚きST_SORROW：悲しみ
st_respirator
予約している未使用項目
-
Last updated
Was this helpful?