ホーム API/ツール API 画像認識

画像認識

    画像認識APIは、画像内の物体や背景情報をもとに名称等を返却するAPIです。現在4つの機能を提供しており、(1)料理やランドマーク等を認識するカテゴリ認識機能、(2)画像内の複数の物体の位置と種類を特定する物体検出機能、(3)画像と似た画像を検索できる類似画像検索機能、(4)書籍や食品パッケージの種類を認識するオブジェクト認識機能をご利用いただけます。

    画像認識API利用イメージ
    API
    基本情報

    ■画像認識(カテゴリ認識、物体検出、類似画像検索、オブジェクト認識)

    提供 : REST※1, SDK(Android, iOS, Server side JAVA)

    ※1 ユーザデータ登録、カテゴリ認識、物体検出、類似画像検索はRESTのみ提供

    ご利用いただくためには「アカウント登録(無料)」が必要です。

    リファレンスを参照するAPI機能名を選択してください

    カテゴリ認識

    画像に写っているものが、指定されたモデルの中のどのカテゴリに属するのかを判定し、そのカテゴリの名称と判定の確からしさを表すスコアを返却します。被写体のカテゴリを認識する際は、被写体の正面をできるだけ大きく撮影してください。

    テクニカルガイドライン

    本機能の使用には、カテゴリの集合体である モデル名 を指定する必要があります。認識に要する時間は、通信環境にも依存しますが、最短1秒程度です。

      リクエスト数制限に関して

    • 認識を行った際に403エラーを受信する場合がございます。このエラーが発生した場合は、 ガイドライン 記載のリクエスト数制限を超えた可能性がございます。本制限を超えて、ご利用を希望される場合は、 docomo Innovator support よりご相談ください。
    • 質問画像(入力画像)の注意事項

    • JPEG,PNG,GIF,BMPまたはTIFF形式の画像データ(透過PNGは対象外)
    • 推奨画像サイズはVGA(640×480)相当。縦長・横長のどちらも可
    • 物体を認識する際は、被写体の全体を、正面から大きく撮った写真が望ましい
    • アップロードする画像サイズの上限は10MB(アップロード画像が大きいほど、処理時間が増加します)
    •  画像認識の精度が落ちる質問画像(入力画像)

    • VGA相当よりも画像サイズが小さい場合
    • 画質が悪い場合
    • 被写体の一部が隠れている場合

    リクエストURL

    https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/concept/classify/

    メソッド : POST
    文字コード : UTF-8

    リクエストヘッダ

    キー 必須 説明
    Content-Type リクエストボディのコンテンツタイプを指定。
    multipart/form-data

    リクエストクエリパラメータ

    キー 必須 説明
    APIKEY APIにアクセスするアプリの認証に利用する。

    リクエストボディ(multipart/form-data形式)

    キー 必須 説明
    modelName 認識対象物に合わせて、認識に用いるモデルを切り替えるために用いる。
    モデル名一覧 から指定する。
    image 画像ファイル(バイナリ)

    レスポンスヘッダ(処理成功)

    キー 必須 説明
    Content-Type 受信データのMIMEタイプは、下記を返却。
    application/json;charset=UTF-8

    レスポンスボディ(処理成功)

    キー 必須 説明
    jobId

    認識ジョブの識別ID。

    サンプル値) 142505_4NJ31TGOWd

    candidates

    認識結果一覧

    オブジェクトのリストになっており、各オブジェクトが認識結果の各候補。 スコアが高い候補と、そのスコアを上位5件返却。

    tag

    カテゴリ名

    入力画像に対して適切と推定される、カテゴリ名。

    score 認識結果候補の確からしさを表すスコア。

    レスポンスヘッダ(処理失敗)

    キー 必須 説明
    Content-Type 受信データのMIMEタイプは、下記を返却。
    application/json;charset=UTF-8

    レスポンスボディ(処理失敗)(JSON形式)

    キー 必須 説明
    error エラーオブジェクト。
    code エラーコードを参照
    message エラーメッセージ(機能コード : エラー内容)を参照

    リクエストサンプル

    POST https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/concept/classify/?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    Content-Type:multipart/form-data;boundary=------FormBoundary15045a68a00
    ------FormBoundary15045a68a00
    Content-Disposition: form-data; name="modelName"
    
    sample
    ------FormBoundary15045a68a00
    Content-Disposition: form-data; name="image"; filename="sample.png"
    Content-Type: image/png
    
    画像データ(binary)
    ------FormBoundary15045a68a00--

    cURLコマンドサンプル

    curl -F "image=@質問画像ファイル名" -F "modelName=food" -k https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/concept/classify/?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

    レスポンスサンプル(処理成功)

    Content-Type: application/json;charset=UTF-8
    {
      "jobId": "131249_VlHYfXxlrD",
      "candidates": [
        {
          "tag": "オムライス",
          "score": 0.2649916708469391
        },
        {
          "tag": "たらこパスタ・明太子パスタ",
          "score": 0.08962514251470566
        },
        {
          "tag": "おせち料理",
          "score": 0.06445780396461487
        },
        {
          "tag": "フライドポテト",
          "score": 0.05321280658245087
        },
        {
          "tag": "ケバブ",
          "score": 0.04915011674165726
        }
      ]
    }

    レスポンスサンプル(処理失敗)

    Content-Type: application/json;charset=UTF-8
    {
        "error": {
          "code": "105",
          "message": "Request body is invalid format."
        }
    }

    モデル名一覧

    指定できるモデルの一覧です。リクエストボディのmodelNameに下表のmodelName値を指定します。

    ※各モデルの認識結果として返却されるカテゴリの名称や種類については、一覧表をご用意しております。 下記よりダウンロードが可能です。

    認識対象物一覧表をダウンロード

    モデル名 概要 modelName値
    シーン "結婚式"等のイベント、"水族館"、"遊園地"等の場所、"動物"、"花"等のシーン。シーンの数は約40種類 scene
    ファッション(柄) "ドット"、"ストライプ"等のパターン・柄 fashion_pattern
    ファッション(洋服の種類) "コート"、"スーツ"等の洋服の種類 fashion_type
    ファッション(~系) "カジュアル"、"ビジネス"のファッションの系統 fashion_style
    ファッション(色) "ホワイト系"、"レッド系"等の色 fashion_color
    料理 "カレーライス"等の料理の名称。料理の数は約160種類 food
    "バラ"等の花の名称。花の数は約40種類 flower
    毒キノコ "カエンタケ"等の毒キノコの名称。キノコの数は約40種類(一部毒キノコでないものを含む) kinoko
    ランドマーク "城"、"寺"、"神社"、"ビル"、"橋"、"美術館"等の観光名所。ランドマークの数は約1,301種類 landmark

    よくあるご質問
    APIなどの各サービスに関するよくある質問を掲載します。
    お問い合わせ
    「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。