【大阪 / 横浜 / 徳島】インフラ / サーバーサイドエンジニア募集中！

【導入実績 500社以上】AWS 構築・運用保守・監視サービス

【CentOS 後継】AlmaLinux OS サーバー構築・移行サービス

【WordPress 専用】クラウドサーバー『ウェブスピード』

【格安】Webサイトセキュリティ自動診断「クイックスキャナー」

【予約システム開発】EDISONE カスタマイズ開発サービス

【100URLの登録が0円】Webサイト監視サービス『Appmill』

【200ヶ国以上に対応】グローバル eSIM「ビヨンドSIM」

【中国への旅行・出張・駐在なら】中国SIMサービス「チョコSIM」

【グローバル専用サービス】北米・中国でも、ビヨンドのMSP

【YouTube】ビヨンド公式チャンネル「びよまるチャンネル」

【2016年】MicrosoftのEmotion APIでTGS2016のベストコンパニオンを決める【振り返り】

2016.12.29

Webシステム開発

1 MicrosoftアカウントでEmotion APIを使う準備
2 お試しなら、curlがよろしいようで。
3 PHPに書き直してみる
4 データは揃った。いざ審査へ・・・！
5 衝撃の結果・・・。そして。
6 誰が大賞あげるって言いましたか？

こんにちは。
開発チームのワイルド担当、まんだいです。

奥さんにかぼちゃの煮物を作るから、かぼちゃを切って面取りしておいて、と言われて久しぶりに面取りしました。
和食の繊細さ、見習わないといけませんね。

今日はMicrosoftのEmotion APIを使いたい、ということで、ネタを探していたのですが、手元でネタになりそうな画像がTokyo Game Show 2016（トーキョーゲームショウ2016。以下、TGS2016）のコンパニオンさんの画像くらい。
という訳で、「2016年振り返り企画！ TGS2016のベストコンパニオン決定戦」を開催したいと思います！

MicrosoftアカウントでEmotion APIを使う準備

Emotion APIを叩くために、API Keyが必要になりますので、まずは、Microsoft Cognitive Servicesのサイトから、Emotion APIを使うための準備をします。

右上の「My Account」のリンクから、ログイン画面へ進むと、

Microsoftアカウント
Githubアカウント
LinkdInアカウント

の3つから、ログインできるようです。
LinkdInがなぜあるのか、謎でしたが、そういえば、Microsoftに買収されていましたね。

無事ログインができたら、右上の「Sign Out」の隣りにある「Get started for free」から、使いたいAPIを有効化します。

今回は、Emotion APIを有効化します。
「Product Name」が「Emotion」となっているセレクトボックスにチェックを付け、下の方にある「I agree to the Microsoft Cognitive Services Terms and Microsoft Privacy Statement.」にもチェック。
後は、「Subscribe」を押せば、準備は完了です。

画面が切り替わったら、現在有効になっているAPIのリストが表示されます。

現在（2016年12月27日）のところ、Emotion APIはプレビュー版なので、月に30000回まで無料で利用可能です。
GCPのVision APIとは、少し価格体系が違いますが、月に1000ユニットまでが無料枠になっています。
ユニットという単位が少しわかりにくいですが、分析項目の事で、顔認識をするなら、1ユニット、テキスト認識するなら、更に1ユニット、という風に1つの画像で、複数の項目のデータを取得する事ができます。

もう少し突っ込んだ話をすると、Vision APIの方が、情報量が多いのが特徴です。
顔認識一つとっても、顔のパーツ位置まで細かく取得できるので、その後何かの加工にも役立つかも知れません。

話は戻って、Emotion APIの有効化したら、API Keyを取得しなければいけません。
APIを有効にした時点で、2つのAPI Keyが有効になっていますので、どちらかを使えばいいと言うわけです。

リストにある、Keysの項目に「X」で伏せ字になっているのがAPI Keyなので、Showを押してコピーするもよし、Copyのリンクを押してコピーするもよし、です。

API Keyを無事取得できたら、ここでの作業は完了です！

お試しなら、curlがよろしいようで。

Linux環境が手元にあるなら、curlを使って、手早く試す事ができます。

Emotion APIのドキュメントには、インターネット上のファイルのURLをJSON形式で送信するサンプルがありますが、今回はcurlから、ローカルにあるバイナリファイルを直接送ってみます。

curl -v -X POST "https://api.projectoxford.ai/emotion/v1.0/recognize" \
  -H "Content-Type: application/octet-stream" \
  -H "Ocp-Apim-Subscription-Key: [API Key]" \
  --data-binary "@[/path/to/image]"

ファイルを直接送る場合は

Content-Typeを「application/octet-stream」
--data-binaryオプションに、画像のパス

を入力します。

200番のレスポンスと、以下のようなJSONデータが返ってきたら、成功です。
（見にくいので改行とタブで整形していますが、1行のデータです）

[
    {
        "faceRectangle":{
            "height":184,
            "left":223,
            "top":217,
            "width":184
        },
        "scores":{
            "anger":2.41070044E-08,
            "contempt":4.531843E-06,
            "disgust":7.3893716E-07,
            "fear":1.44139625E-08,
            "happiness":0.9999242,
            "neutral":6.80201556E-05,
            "sadness":3.14932123E-07,
            "surprise":2.19046137E-06
        }
    }
]

ここまでできれば、かなり遊べますね。

PHPに書き直してみる

取得した解析データは、加工したり、webページを作成して並べたり、色々面白い事ができそうです。
今回はDBに解析データを入れて遊びたいので、PHPに書き直してみます。
といっても、上記のコマンドを落とし込むだけです。

$url = 'https://api.projectoxford.ai/emotion/v1.0/recognize';
$subscription_key = 'your api key';
$path = '/path/to/image';

$ch = curl_init($url);

curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/octet-stream',
        'Ocp-Apim-Subscription-Key: '. $subscription_key,
    ],
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HEADER => true,
    CURLOPT_VERBOSE => true,
    CURLOPT_POSTFIELDS => file_get_contents($path),
]);

$res = curl_exec($ch);

後は、ファイルのリストを作成して、ループすれば、大量の画像を解析できますね。
ただし、20回/分という制約があるので、sleepなどで時間調整が必要なのをお忘れなく。

試しに200枚くらいの画像を解析してみましたが、結果は良好でした。
何度も叩くのは、利用回数の制限もあってもったいないので、取得したデータはDBに格納するなりしておくのが良いですね。