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

画像認識

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

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

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

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

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

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

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

    辞書作成

    1つ以上のデータセットから辞書を作成します。

    テクニカルガイドライン

    1つ以上のデータセットから辞書を作成します。指定したデータセットの組み合わせが画像認識の対象範囲となります。 辞書作成処理には時間がかかるため、辞書作成状況確認で作成状況を確認する必要があります。 なお、画像認識機能には、この他に、ユーザカテゴリの作成機能でカテゴリを作成し、ユーザカテゴリのデプロイ機能を使用し本機能で作成した辞書をカテゴリにデプロイする必要があります。

    制限事項

    • APIKEY毎に本機能を利用できる回数が制限されています。 ※1
    • 作成可能な辞書の数には上限があります。 ※1
    • 辞書パラメータ一覧に記載の辞書パラメータしか選択できません。 ※1

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

    リクエストURL

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

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

    リクエストヘッダ

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

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

    キー 必須 説明
    APIKEY APIにアクセスするアプリの認証に利用する。
    token ユーザトークン取得にて払い出されるユーザトークン。

    リクエストボディ(JSON形式)

    キー 必須 説明
    dicParam 辞書パラメータ
    ※辞書パラメータ一覧を参照。
    dicId 辞書ID
    作成する辞書を識別するためのId。文字クラス[a-zA-Z0-9_¥-]に所属する文字で構成された任意の文字列を指定
    dataSetIds データセットID
    辞書に登録するデータセット。
    複数指定可能。

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

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

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

    キー 必須 説明
    creatingDicJobId 辞書作成ジョブID
    辞書作成状況確認にて辞書の作成状況を確認をするために必要なジョブId。

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

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

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

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

    リクエストサンプル

    POST https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/userCategory/createDic?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&token=1234567890
    Content-Type: application/json;charset=UTF-8
    {
        "dataSetIds":[
            "data-1",
            "data-2"
        ],
        "dicId":"dic-1",
        "dicParam":"dummyParam1"
    }

    cURLコマンドサンプル

    curl -X POST -H "Content-type: application/json charset=utf-8" -d '{"dicId":"dic-1","dataSetIds":["data-1","data-2"],"dicParam":"dummyParam1"}' 'https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/userCategory/createDic?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&token=1234567890'

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

    Content-Type: application/json;charset=UTF-8
    {"creatingDicJobId":"1"}

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

    HTTP/1.1 XXX
    Content-Type: application/json;charset=UTF-8
    {
        "error": {
            "code": "101",
            "message": "The API you requested is not supported."
        }
    }

    辞書パラメータ一覧

    辞書パラメータ 説明
    h7oEqe3X デフォルト辞書パラメータ

    進捗状況確認方法

    POST https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/userCategory/creatingDicStatus?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&token=1234567890&creatingDicJobId=1
    よくあるご質問
    APIなどの各サービスに関するよくある質問を掲載します。
    お問い合わせ
    「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。