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

画像認識

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

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

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

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

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

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

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

    不適切な認識結果に対するフィードバック

    画像認識の結果として返却される各種データに関して、不適切・不適当なものがある場合に本機能を用いて報告できます。

    テクニカルガイドライン

    本機能の使用には、あらかじめ画像認識機能で取得したrecognitionIdが必要となります。
    また、itemIdも必要となります。

    リクエストURL

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

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

    リクエストヘッダ

    キー 必須 説明
    Content-Type リクエストボディのコンテンツタイプを指定。
    application/json;charset=UTF-8

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

    キー 必須 説明
    APIKEY APIにアクセスするアプリの認証に利用する。
    recognitionId - 認識ジョブの識別ID。
    画像認識で払いだされたrecognitionId。
    サンプル値) 947ec350-299c-11e4-800f-0afa47a658a2
    itemId フィードバック対象の商品のIdを記載。
    画像認識で払いだされたitemIdを指定。
    サンプル値) book_2101060417
    category フィードバック対象の商品のカテゴリを記載。
    画像認識で払いだされたcategoryを指定。

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

    キー 必須 説明
    comment - フィードバックに任意のコメントを付けることができます。
    文字コードはUTF-8。
    サンプル値) "サンプルコメント"

    レスポンス(処理成功)

    HTTPステータス : 204
    レスポンスボディ : なし

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

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

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

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

    リクエストサンプル

    POST https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/feedbackInappropriate?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&recognitionId=b11b1b22-233f-11e4-8aaf-0afa47a788a2&itemId=book_2101060417&category=book
    Content-Type: application/json;charset=UTF-8
    {
    "comment": "サンプルコメント"
    }

    cURLコマンドサンプル

    curl -X POST -d '{"comment":"サンプルコメント"}' 'https://api.apigw.smt.docomo.ne.jp/imageRecognition/v1/feedbackInappropriate?APIKEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&recognitionId=b11b1b22-233f-11e4-8aaf-0afa47a788a2&itemId=book_2101060417&category=book'

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

    HTTP/1.1 204 No Content
    Content-Type: text/html;charset=UTF-8

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

    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モードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。