【API/マッシュアップ】「男の娘WebAPI」を試す

顔認識APIでおなじみのPUXより男の娘WebAPIという最高にクールで斜め上なAPIが公開されたので試しに使ってみました。

ADs

男の娘WebAPIとは何ができるAPIなのか

独自の顔認識技術により指定された画像から顔や顔の部品の位置を検出、「年齢、性別、目・鼻・口・輪郭の形」などの情報を解析し、「男の娘度合」などの判定結果を返します。レスポンスはJSON形式で取得できます。

本APIでは「男の娘とは、男の子なのに女の子のように可愛らしい」とし、推定される性別が「ほぼ確実に女性」である場合「男の娘度合」は低い値となります。

※仕様書より

以前から公開されているPUXの顔認識APIは精度が高いことはもちろんですが、得られる情報も感情や性別、年齢など多岐に渡ります。その高い解析技術を応用したものがこの男の娘WebAPIなのでしょう。最高です。

使い方

指定URLにAPIKeyや画像ファイルなどのパラメーターをPOSTで渡すだけなので、JavascriptでもPHPでもそれ以外の言語でも使いやすいのではないかと思います。

渡す画像をURL・base64・formからのPOST送信の3種で受けてくれるのがいいですね。多様な使い方ができそうです。

リクエストURL
http://limited.api.polestars.jp:8080/webapi/prettyface.do

HTTPメソッド
POST

リクエストパラメータ

apiKey (必須)	【APIKEY.txt】に記載されているAPIキーをご使用ください。
imageURL (いずれか必須)	画像のURLを利用する場合はこのパラメータを指定します。 Content-Type=”application/x-www-form-urlencoded”
inputFile (いずれか必須)	フォームを利用して画像を送信する場合はこのパラメータを指定します。 Content-Type=”application/maltipart-formdata”
inputBase64 (いずれか必須)	base64文字列で画像を指定する場合はこのパラメータを指定します。 Content-Type=”application/x-www-form-urlencoded”
– (いずれか必須)	リクエストボディにバイナリデータを書き込んでください。 Content-Type=”application/octet-stream”
eliminateOlder (省略可)	若年層限定オプションの有効・無効を選択できます。当オプションが有効の場合、20代後半以降と推定される方を判定対象から除外します。 0：無効, 1：有効のいずれかを指定できます。このパラメータが省略された場合はオプション有効として実行します。