０．はじめに
こんにちは。この記事は国産Web API Advent Calendar 2018の9日目の記事です。
クリスマスが近いですね。みんなが大好きな食べ物といえば、肉！
リクルートがA3RTという人工知能APIを公開しており、その中でも画像系の人工知能APIを使って、肉のSNS映え度を判定を試してみたいと思います。
ちなみに、今回紹介する機能に雑談機能やMicrosoft AzureのVisionAPIの機能を組み合わせたLINEのチャットボットを作ったので、参考に紹介しておきます。今回作るのはインスタ映えを判定している部分です。
リクルートの人工知能APIとMicrosoftのVisionAPIを合わせた肉のインスタ映え診断LINEボット完成。言語はPython。環境はHerokuです。#駆け出しエンジニアと繋がりたい pic.twitter.com/D2k3x8rHJ9
— さい (@saisan78) 2018年12月9日
１．この記事の対象者
- プログラミング初心者でAPIを使うことに興味がある人
- Restlet Clientを利用したAPIのテスト方法が学べます
- PythonでAPIを使って見たい人
- Reqestsモジュールを使ったPOSTの使い方を簡単に紹介します 。（multipart/form-dataをrequestsを使ってPOSTする方法となります。）
- リクルートのA3RTの雰囲気を知ってみたい人
- 今回はImage Influence API
- なんといっても肉が好きな人：後半は肉の写真が登場
- 国産APIを応援している人
少し長くなるので、右の各章のリンクから興味のあるところだけでも読んで頂けると幸いです。
２．A3RTとは
3RT（アート）は「ANALYTICS & ARTIFICIAL INTELLIGENCE API VIA RECRUIT TECHNOLOGIES」の略称で、リクルートグループ内の機械学習のノウハウが詰まったAPIだそうです。
https://a3rt.recruit-tech.co.jp/
今回はその中でも、Image Influence APIというものを使用して、肉のインスタ映え度判定を行います。たくさんの肉画像をあらかじめ学習しており、ユーザが投稿する肉画像について、どれ位インスタ映えするのか0~9点で教えてくれるようです！
Image Influence APIは、画像の”影響度”を測り、多くの人に注目されやすい画像の判別に利用します。最終的には全ての種類の画像に対応したいのですが、まずは肉の画像にフォーカスを当てています。
例えば、お店の紹介ページに載せる画像として、肉の映った画像AとBどちらが良い印象を与えるか迷った時や、FacebookやinstagramなどのSNSにアップする画像が複数あり、どちらがイイねを多くもらえるか迷った時、などに利用してみてください。
また、自分で画像と点数を集めてモデルを作成すると、その傾向を学習して未知の画像に対する点数を、あなたの基準で返却するようなモデルも作成可能です。
３．APIキーの取得
APIの取得はとっても簡単です。Productページからメールアドレスを登録するだけ。
他のAPIと違って、クレジットカード情報や住所などの個人情報もいりません。
メールの認証を済ませると、登録したメールにAPIキーが送られてきます。
４．REST APIテストツールで試してみる！
いきなりコーディングしてもいいのですが、今回はAPIを試す練習もかねて、APIテストツールを使います。色々あるのですが、Chromeのアドオンとして使えるRestlet Client - REST API Testingを使いたいと思います。
(参考に読みたい記事) Restlet Clientで始めるREST APIテストの自動化
それでは、早速公式のReferenceページを見ながら、試していきましょう。
リクエストパラメータを見ると、以下の３つをエンドポイント（APIのURL）に送ればいいようです。
- apikey ※メールで取得しましたね
- predict ※適当な数値で良さそうです
- imagefile ※3MB以下という、画像ファイルのサイズに注意しておきたいですね
まず使用する画像はこちらのいらすとやの美味しそうなステーキです。
それでは、Restlet Clientに必要なパラメータを入れて見ましょう。
最後にSendをポッチとすると、下のほうにレスポンスが帰ってきます。
なんと、"3.422203540802002"点！ 満点は９点なので低めですね。
それでは、リクルートのホットペッパーの記事に使われている画像を使わせていただきます。
https://www.hotpepper.jp/SA11/dncLU0054/
うーん、"4.6302995681762695"点。画像の解像度が良くないのかも知れません。
５．Pythonで実行してみる
それではAPIテストツールでの実行方法をPythonでもやってみます。
Restlet Clientには、cURLコマンドに変換する機能があります。
以下のキャプチャ画像のように今回のテスト内容をcURLに変換しましょう。
さらに、ｃURLコマンドをPythonのReqestに変換できるサイトを使うことで簡単にコードを作成します。今回は、curl.trillworks.comを使用します。
そして完成したコードがこちらになります。たったの12行です。肉画像のファイルのパスはご自分の保管場所なので気をつけてくださいね！
import requests
URL = 'https://api.a3rt.recruit-tech.co.jp/image_influence/v1/meat_score'
APIKEY = '秘密' #自分のAPIキーを入れてね
headers = {'Content-Type': 'multipart/form-data'}
files = {
'apikey': (None, APIKEY),
'predict': (None, '1'),
'imagefile': ('肉画像.jpg', open('肉画像.jpg', 'rb'))
}
r = requests.post(URL, files=files)
score = r.json()['result']['score'] #scoreを表示する部分を追加で作ります
print(score)
６．いろんな肉画像（フリー）を試してみる
最後に色々な肉画像のスコアがどうなるか試してみます。
pexels.comより、フリーで使用できるものを使用しています。
■Score: 4.536550998687744
https://www.pexels.com/photo/steak-food-769289/
■score: 3.3790462017059326
https://www.pexels.com/photo/raw-meat-on-brown-wooden-surface-1539684/
■score: 4.49148416519165
https://www.pexels.com/photo/chicken-close-up-dish-food-265393/
■score: 4.612046241760254
https://www.pexels.com/photo/cooked-sausage-929137/
残念ながら５点以上の肉画像が見つからず。ハイスコアとなる基準が謎ですね。笑
学習データを持っているリクルートの中の人だけが知っているのだと思います。
７．まとめ
- APIのおかげで誰でも簡単に（今回はたったの12行）で人工知能を使えるようになった！
- RESTAPIテストツールや、cURLからのReqestsコマンド変換など、初心者でもコードを作りやすいツールが実はたくさんある！
- 画像の分類など、分類するもの、分類の目的がはっきりとしてきたらカスタマイズを行う必要があり
- 肉をいっぱいたべよう
みなさんよい年末を。
おまけ
人に教えること、勉強することが好きです。色々と学んだことを記事で共有していきたいと思います！
-【COTOHA API】NTTグループの40年にわたる研究成果を使って、西野カナさんの年齢を予測する【Python】
-【Pythonたったの12行】リクルート人工知能APIに肉のインスタ映え診断をしてもらう