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組み合わせ用コンテナ
    • エラーレスポンス

  • 使用上の注意

複数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--

レスポンス

ルートオブジェクトの candidates には物体検出のレスポンスが設定され、さらにその内部の secondAPIs に組み合わせたAPIのレスポンスが設定されます。

ボディ
JSONキー 値 必須
jobid 文字列 ○
detectjobid 文字列 〇
status 文字列 ○
candidates object配列 〇
  • jobid
    物体認識 API のプロトコルバージョン です。

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

    Status 意味
    success 成功
    failure 失敗
  • candidates

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

    JSONキー 値 必須
    tag 文字列 ○
    score 実数 ○
    xMin 実数 〇
    yMin 実数 〇
    xMax 実数 〇
    yMax 実数 〇
    secondAPIs オブジェクト配列  ○
    • tag
      分類した画像のラベルです
    • score
      分類した画像の精度を表します。値の範囲は-2147483648~2147483647です。
    • xMin
      矩形の左上のX座標です。
    • yMin
      矩形の左上のY座標です。
    • xMax
      矩形の右下のX座標です。
    • yMax
      矩形の右下のY座標です。
    • secondAPIs
      後段APIの結果です。
    • secondAPI objects
    • JSONキー 値 必須
      apiName 文字列 ○
      jobid 文字列 ○
      status 文字列 〇
      candidates オブジェクト配列  ○
      • apiName
      • 後段APIの名称です。
      • jobid
      • 後段APIの処理IDです。
      • status
      • 後段APIの処理ステータスです。"success", "failure"などがあります。
      • candidates
      • 後段APIの処理結果がオブジェクト配列の形で返却されます。
        具体的な内容につきましては、各APIに準拠しますので、それぞれのリファレンスをご参照ください。
  • サンプル
  • {
      "candidates": [
    {
    "score": 0.9588778018951416,
    "xMax": 239.06044006347656,
    "xMin": 133.04527282714844,
    "yMin": 61.752620697021484,
    "tag": "face",
    "yMax": 196.22528076171875,
    "secondAPIs": [
    {
    "candidates": [
    {
    "score": 0.8470529913902283,
    "tag": "cat"
    },
    {
    "score": 0.15294697880744934,
    "tag": "dog"
    }
    ],
    "jobId": "20210329144012215_GyuaThPcIp91Yh7boN2TitrDZVcQaBd8",
    "status": "success",
    "apiName": "classify"
    }
    ]
    }
    ],
    "jobId": "20210329144010227_1657?saveFlag=false",
    "status": "success",
    "detectJobId": "20210329144012095_42hXAW8iQ8bt0udvSwPJs2SUaD7y36Yv"
    }
← 文字認識 エラーレスポンス →
  • 概要
  • リクエスト
  • レスポンス
  • ※「docomo MEC」は株式会社NTT ドコモの商標です。
docomo
© NTT DOCOMO, INC. All Rights Reserved