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キー 値 必須
    overlap 実数  
    threshold 実数  
    image 画像ファイルのバイナリ ○
    targetRegion 文字列  
    • overlap
      overlap = 2つの矩形の積集合の面積 / 2つの矩形の和集合の面積 です。このオーバーラップ値の閾値を上回った場合に、スコアが大きい方の矩形の情報のみを返却します。値の範囲は0.0〜1.0です。

    • threshold
      スコアがthresholdを上回った矩形だけを返却します。値の範囲は0.0〜1.0です。

    • image
      検出する画像ファイルです。対応しているフォーマットはJPEG、png、bmp、gif、tiffです。

    • targetRegion
      imageの画像の中でtargetRegionの領域だけを検出対象とします。フォーマットは対象領域のLeft、Top、Right、Bottomの整数座標を , 区切りで指定します。

    • サンプル

      ------WebKitFormBoundaryhwZz6hhFHARN6wAB
      Content-Disposition: form-data; name="overlap"
      0.3
      ------WebKitFormBoundaryhwZz6hhFHARN6wAB
      Content-Disposition: form-data; name="threshold"
      0.3
      ------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 実数 ○
    xMin 実数 ○
    yMin 実数 ○
    xMax 実数 ○
    yMax 実数 ○
    • tag
      検出した物体のタグ名です。
    • score
      検出した物体の精度を表します。値の範囲は0.0〜1.0です。
    • xMin
      検出した矩形の左上x座標です。
    • yMin
      検出した矩形の左上y座標です。
    • xMax
      検出した矩形の右下x座標です。
    • yMax
      検出した矩形の右下y座標です。
  • サンプル

    {
        "jobId": "20200713101016366_10080",
        "status": "success",
        "candidates": [
            {
                "tag": "cat",
                "score": 0.9996671676635742,
                "xMin": 334.62042236328125,
                "yMin": 66.42976379394531,
                "xMax": 420.01275634765625,
                "yMax": 160.2348175048828
            }
        ]
    }
← 一般物体認識 類似画像検索 →
  • 概要
  • リクエスト
  • レスポンス
  • ※「docomo MEC」は株式会社NTT ドコモの商標です。
docomo
© NTT DOCOMO, INC. All Rights Reserved