docomo MEC™ docomo MEC™ docomo MEC™
お問い合わせ ドキュメント ログインページ
検索
お問い合わせ ドキュメント ログインページ
  • Compute V
  • Compute O
  • Compute D
  • MECダイレクト
  • MECダイレクト(SA)
  • ドコモ画像認識PF
  • ネットワークセキュリティサービス
  • docomo MECポータルへのログイン方法
  • 用語集
  • 改訂履歴
Compute V
Compute O
Compute D
MECダイレクト
MECダイレクト(SA)
ドコモ画像認識PF
ネットワークセキュリティサービス
docomo MECポータルへのログイン方法
用語集
改訂履歴

›リファレンス

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

  • はじめに
  • 一般物体認識

    • 画像収集
    • アノテーション
    • データセット
    • 学習
    • 評価
    • デプロイ
    • 推論
    • クリーンアップ

    物体検出

    • 画像収集
    • アノテーション
    • データセット
    • 学習
    • 評価
    • デプロイ
    • 推論
    • クリーンアップ

    類似画像検索

    • 画像収集
    • アノテーション
    • データセット
    • デプロイ
    • データの追加
    • 推論
    • クリーンアップ

    特定物体認識

    • 画像収集
    • アノテーション
    • データセット
    • 辞書作成
    • デプロイ
    • 推論
    • クリーンアップ

    姿勢推定

    • 概要
    • デプロイ
    • 推論
    • クリーンアップ

    文字認識

    • 概要
    • デプロイ
    • 推論
    • クリーンアップ

    複数API組み合わせ用コンテナ

    • 概要
    • デプロイ
    • 推論
    • クリーンアップ

    管理画面

    • 認証キー管理
    • アノテーション管理
    • 学習モデル管理
    • 辞書管理
    • API管理
    • ユーザー管理

    APIリファレンス

    • 一般物体認識
    • 物体検出
    • 類似画像検索
    • 特定物体認識
    • 姿勢推定
    • 文字認識
    • 複数API組み合わせ用コンテナ
    • エラーレスポンス

  • 使用上の注意

特定物体認識

概要

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

リクエスト

  • エンドポイント POST https://imagepf.dcm-dc.biz/api/predict?auth_key={APIKEY}

    key 値 必須 説明
    APIKEY 文字列 ○ 払い出したAPIキーを設定します
    • ボディ

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

      multipartキー 値 必須
      image 画像ファイルのバイナリ ○
      • image
        分類する画像ファイルです。対応しているフォーマットはJPEG、png、bmp、gif、tiffです。

      • サンプル

         	
        ------WebKitFormBoundaryhwZz6hhFHARN6wAB--
        Content-Disposition: form-data; name="image"; filename="sample.png"
        Content-Type: image/png
        画像データ(binary)
        ------WebKitFormBoundaryhwZz6hhFHARN6wAB--

レスポンス

 ボディ
JSONキー 値 必須
Version 文字列 ○
Status 文字列 ○
Recognition-id 文字列 〇
Candidates object配列  
  • Version
    物体認識 API のプロトコルバージョン です。

  • Status
    処理状態です。
    状態は以下の通りです。

     

    Status 意味
    SUCCESS 成功
    ILLEGAL_REQUEST リクエスト、あるいは投稿された画像に問題がある場合
    INTERNAL_ERROR 認識エンジン側でエラーが発生した場合
  • Recognition-id
    認識結果に対するフィードバックを行うため、 送信した画像と、その認識結果を結びつける ID です。

  • Candidates
    分類結果のcandidates objectをスコアの高い順にソートして配列で設定します。

  • candidates object

    JSONキー 値 必須
    Label 文字列 ○
    score 実数 ○
    InlierPatchCount 実数  
    Coordinates 文字列  
    Mappings object配列  
    • Label
      分類した画像の識別名です。
    • score
      分類した画像の精度を表します。値の範囲は-2147483648~2147483647です。
    • PatchCount
      入力画像と教師画像とでマッチングしたキーポイントの個数を表します。
    • InlierPatchCount
      入力画像と教師画像とでマッチングして、なおかつ位置関係に整合性があるキーポイントの個数を表します。
    • Cooridinates
      Mapping 要素の座標系を示します。
    • Mappings
      分類した画像のタグ名です。
    • Mappings object
      JSONキー 値
      Type 文字列
      X 実数
      Y 実数
      • Type
        Mapping の種類が表示されます。たとえば、 point などと表示されます。
      • X
        Mapping の X 座標が表示されます。
      • Y
        Mapping の Y 座標が表示されます。

サンプル

{
  "Version": "4.1",
  "RecognitionID": "some-recognition-id-is-shown",
  "Status": "SUCCESS",
  "Candidates": [
    {
      "Label": "8",
      "Score": 57,
      "PatchCount": 26,
      "InlierPatchCount": 0,
      "Coordinates": "QUERY_IMAGE_CORNERS_IN_TRAIN_COORDINATES",
      "Mappings": [
        {
          "Type": "point",
          "X": 0,
          "Y": 0
        },
        {
          "Type": "point",
          "X": 0,
          "Y": 0
        },
        {
          "Type": "point",
          "X": 0,
          "Y": 0
        },
        {
          "Type": "point",
          "X": 0,
          "Y": 0
        }
      ]
    }
  ]
}
← 類似画像検索 姿勢推定 →
  • 概要
  • リクエスト
  • レスポンス
  • ※「docomo MEC」は株式会社NTT ドコモの商標です。
docomo
© NTT DOCOMO, INC. All Rights Reserved