姿勢推定エンジン

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キー	値	必須
  image	画像ファイルのバイナリ	○
  targetRegions	JSON形式の文字列
  threshold	float

  • ・image
      分類する画像ファイルです。対応しているフォーマットはJPEG、png、bmp、gif、tiffです。
  • ・targetRegions
      darkposeで利用するROI情報です。
      設定例
    
    {
   "targetRegions":[
    {
      "xMin": 149.88,
      "yMin": 218.10,
      "xMax": 219.28,
      "yMax": 411.9
    }
  ]
}

  • ・threshold
      darkposeで利用するヒートマップの閾値です。
     (0 <= threshold < 1) 
      未指定時はモデルファイルの設定値を用います。
  • ・サンプル
    ------WebKitFormBoundaryhwZz6hhFHARN6wAB
Content-Disposition: form-data; name="modelName"
"sample"
------WebKitFormBoundaryhwZz6hhFHARN6wAB--
Content-Disposition: form-data; name="image";filename="sample.png"
Content-Type: image/png
画像データ(binary)
------WebKitFormBoundaryhwZz6hhFHARN6wAB

• ・ボディ

  JSONキー	値	必須
  jobId	文字列	○
  status	文字列	○
  candidates	object配列

  • ・jobId
      画像分類の処理IDです。
  • ・status
      処理成功の場合、successを返却します。
    
  • ・candidates
    分類結果のcandidates objectをスコアの高い順にソートして配列で設定します。
      candidates object    

    JSONキー	値	必須
    tag	文字列	○
    id	文字列	○
    keyPoints	object配列	○

  • ・tag
      分類した画像のタグです。
    
  • ・id
      分類した画像のidです。
    
  • ・keyPoints
      分類した画像の関節に関する情報です。
    
  • ・Key Points object   

    JSONキー	値
    name	文字列
    x	実数
    y	実数
    score	実数

  • ・name
      keyPoint の名前が表示されます。たとえば、nose などと表示されます。
      なお、 name ではなく各keyPointの名前がそのままjsonキーとなりますのでご注意ください。
      KeyPointは、 nose, neck, shoulderRight , elbowRight , wristRight , shoulderLeft , elbowLeft , wristLeft , hipRight , kneeRight , ankleRight , hipLeft , kneeLeft , ankleLeft , eyeRight , eyeLeft , earRight , earLeft となります。
  • ・x
      keyPoint の X 座標が表示されます。
  • ・y
      keyPoint の Y 座標が表示されます。
  • ・score
      keyPointに対する適合度です。
   

  • ・サンプル

    {
  "jobId":"abcde",
  "status": "success",
  "candidates":[
   {
     "tag":"people",,
     "id":"0001",
     "keyPoints":{
          "nose": {
              "x": 322,
              "y": 533,
              "score": 0.6548669934272766,
            },
           :
           （略）
           :
          "earLeft": {
              "x": 289,
              "y": 550,
              "score": 0.4321119332372344,
          }
       }
   },
   {
     "tag":"people",
     "id":0002,
     "keyPoints":{
          "nose": {
              "x": 620,
              "y": 520,
              "score": 0.5442992933252732,
          }
           :
           （略）
           :
          "earLeft": {
              "x": 580,
              "y": 544,
              "score": 0.7299229933252511,
          }
       }
   }
]
}