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

画像認識

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

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

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

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

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

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

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

    画像蓄積領域への画像登録

    画像蓄積領域へ画像ファイル、画像ラベル、画像ファイル名を登録します。

    テクニカルガイドライン

    本機能では、画像ファイル、画像ラベル、画像ファイル名を対象ユーザの画像蓄積領域にアップロードします。本機能でアップロードできる画像は1枚だけであるため、複数の認識対象物を登録したい場合は、本機能を複数回使用して、辞書に登録したい画像を全てアップロードしてください。 なお、画像URL集から一括でデータセットを作成する場合には、本機能ではなく、画像URLからのデータセット作成機能をご利用ください。

    画像ラベル

    • 画像ラベルは、画像認識機能の結果として返却される文字列です。
    • 画像に写っているモノの名前など、画像を識別するための名前や番号を登録してください。

    画像ファイル名

    • 画像ファイルの名前を記録するために利用します。
    • 画像ファイル名は、最終的な画像認識の結果では返却されません。ここで登録した画像ファイル名は、データセット詳細取得機能で確認することができます。

    登録画像の注意事項

    • JPEG,PNG,GIF,BMPまたはTIFF形式の画像データ(透過PNGは対象外)
    • 推奨画像サイズはVGA(640×480)相当。縦長・横長のどちらも可
    • アップロードする画像サイズの上限は10MB
    • 画像は長辺640ピクセルにリサイズして登録してください。

    制限事項

    • 画像蓄積領域内のデータは一定の期間を超えると全て削除されます。 ※1

    ※1 docomo Innovator supportにご参加頂くことで制限の緩和が可能です。

    リクエストURL

    https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/userCategory/uploadTmpImage

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

    リクエストヘッダ

    キー 必須 説明
    Content-Type 受信データのMIMEタイプは、下記を返却。
    application/octet-stream

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

    キー 必須 説明
    APIKEY APIにアクセスするアプリの認証に利用する。
    token ユーザトークン取得にて払い出されるユーザトークン。
    label 画像ラベル
    画像に写っている画像認識対象物の名前を記録する。本画像ラベルは画像認識の結果で返却される。 画像認識の認識結果候補のitemIdとして利用する。
    name 画像ファイル名
    画像ファイルの名前を記録する。 本画像ファイル名は画像認識の結果で返却されない。 利用可能な文字列は[a-zA-Z0-9_\-\.]。最大長は100。

    リクエストボディ(application/octet-stream形式)

    キー 必須 説明
    - 画像データ(バイナリ)

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

    なし

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

    なし

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

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

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

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

    リクエストサンプル

    POST https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/userCategory/uploadTmpImage?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&token=1234567890&name=dummy1%2ejpg&label=dummy1
    Content-Type: application/octet-stream
    画像データ(バイナリ)

    cURLコマンドサンプル

    curl -X POST -H 'Content-type: application/octet-stream' --data-binary "@アップロードするファイル名" 'https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/userCategory/uploadTmpImage?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&token=1234567890&name=dummy&label=dummy'

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

    なし

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

    HTTP/1.1 XXX
    Content-Type: application/json;charset=UTF-8
    {
        "error": {
            "code": "101",
            "message": "The API you requested is not supported."
        }
    }
    よくあるご質問
    APIなどの各サービスに関するよくある質問を掲載します。
    お問い合わせ
    「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。