5 顔検知クイックスタートガイド

Mercury Cloudの顔検出機能を素早く着手するためのガイドが提供されています。

顔検知APIは画像内の顔を検出し、顔枠を外接する長方形の座標を返します。同APIでは、顔の角度、性別、年齢、感情など、顔に関連するいくつかの属性も抽出できます。すべての属性は実際の分類ではなく、AIアルゴリズムによる予測によるものです。

以下の手順では1枚の画像をアップロードし、画像内の顔を検出する方法を記載しています。正常に検出された場合、検出された顔情報が返されます。

5.1 準備

まず、Python環境がインストールされていることを確認してください。次に、下記のPythonファイルをダウンロードしてPythonのパスフォルダーにコピーしてください。

1KB

auth_headers.py

API認証ヘッダー作成

611B

base64_encode.py

写真ファイルをBase64に変換

2KB

detect_faces.py

顔検知

605B

api_parameters.py

APIパラメータ

api_parameters.pyをテキストエディターで開き、パラメーターをお客様の情報に置き換えてください。詳細は3.2節をご参照ください。

api_parameters.pyをテキストエディターで開き、パラメーターをお客様の情報に置き換えてください。詳細は3.2節をご参照ください。

Python

# Common parameters. Used for all API calls.
# Base URL for Mercury Open API.
api_url = "https://mercury.japancv.co.jp/openapi/face/v1"
# Provision App Id for API calls.
app_id = "aabbccdd-eeff-0011-2233-445566778899"
# Provision access key to authentication.
access_key = '00112233-4455-6677-8899-aabbccddeeff'
# Provision secret key to authentication.
secret_key = '13579acegijmoqsuwyACEGIJMOPSUWY'

5.2 顔検知リクエスト送信

次のコマンドを使うことで、顔検出のAPIリクエストを送信し、その画像内の顔を検出することができます。パスは、Pythonライブラリパスと画像ファイルのパスにそれぞれ置き換えてください。

Bash

python {python_path}\detect_faces.py "{image_path}\image.jpg"

結果は次のようになります。顔が検出されたかどうかを示す検出resultsフィールドに、検出された顔の詳細が含まれています。

Detect image: {image_path}\image.jpg
Http status code: 200
Detect face. rectangle: {'top': 625, 'left': 350, 'width': 793, 'height': 818} angle: {'yaw': -0.42474133, 'pitch': 9.596367, 'roll': 0.07245465}
Predicted attributes:
        Age: 29 ~ 39
        Gender: MALE
        Cap: HAT_STYLE_TYPE_NONE
        Glasses: TRANSPARENT_GLASSES
        Mask: COLOR_TYPE_NONE

ここでの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	予約している未使用項目	-