ドコモ画像認識プラットフォーム

一般物体認識エンジン

概要

REST APIエンドポイントに指定のFormデータをPOSTすると分類結果のJSONを応答します。入力画像一枚につき1回APIをリクエストする必要があります。
処理に成功するとHTTPstatus200のステータスコードと共にJSONが応答されます。

リクエスト

  • ・エンドポイント

    POST https://irp.dcm-dc.biz/recognize?auth_key={APIKEY}
     
    key 必須 説明
    APIKEY 文字列 払い出したAPIキーを設定します
  •  
  • ・ボディ

    リクエストボディは Content-Type: multipart/form-data 形式でリクエストを送信します。

    multipartキー 必須
    lang 整数  
    image 画像ファイルのバイナリ
    targetRegion 文字列  
    • ・lang
        タグが複数の言語で登録してある場合に集計するタグの登録番号を指定します。最初に登録してある言語が0番です。登録してある言語の数よりlangの値が大きい時は0番目の言語を集計します。
    • ・image
         分類する画像ファイルです。対応しているフォーマットはJPEG、png、bmp、gif、tiffです。
    • ・targetRegion
         imageの画像の中でtargetRegionの領域だけを分類対象とします。フォーマットは対象領域のLeft、Top、Right、Bottomの整数座標を , 区切りで指定します。
    • ・サンプル
      ------WebKitFormBoundaryhwZz6hhFHARN6wAB
      Content-Disposition: form-data; name="lang "
      0
      ------WebKitFormBoundaryhwZz6hhFHARN6wAB
      Content-Disposition: form-data; name="image"; filename="sample.png"
      Content-Type: image/png
      画像データ(binary)
      ------WebKitFormBoundaryhwZz6hhFHARN6wAB--
      Content-Disposition: form-data; name="targetRegion"
      1,5,10,50
      ------WebKitFormBoundaryhwZz6hhFHARN6wAB

レスポンス

  • ・ボディ

    JSONキー 必須
    jobId 文字列
    status 文字列
    candidates object配列
    • ・jobId
        一意の処理IDです。フォーマットは yyyymmddhhmmssfff_APIID です。
    • ・status
        処理状態です。
    • ・candidates
        分類結果のcandidates objectをスコアの高い順にソートして配列で設定します。
    • ・candidates object   
      JSONキー 必須
      tag 文字列
      score 実数

      • ・tag
          分類した画像のタグ名です。
      • ・score
          分類した画像の精度を表します。値の範囲は0.0〜1.0です。
    •  
    • ・サンプル

      {
          "jobId":"abcde",
          "status": "success",
          "candidates":[
              {
                  "tag": "car",
                  "score": 0.8666
              },
              {
                  "tag"
      : "yoga",
                  "score"
      : 0.8666
              },
              {
                  "tag"
      : "train",
                  "score"
      : 0.8666
              },
              {
                  "tag"
      : "meal",
                  "score"
      : 0.8666
              }
          ]
      }

APIリファレンス

  • Webでのお問い合わせ

  • 電話でのお問い合わせ

    ドコモビジネスコンタクトセンター

    0120-003300

    受付時間:9:00~17:00(土・日・祝日・年末年始を除く)

  • 本サービスは株式会社NTTドコモが提供元であり、NTTコミュニケーションズ株式会社が代理人として保有する契約締結権限、および包括的な業務受託にもとづき販売しています。
  • 画像はイメージです。

このページのトップへ