姿勢推定

概要

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キー	値	必須
  modelName	文字列	〇
  image	画像ファイルのバイナリ	○

  • modelName
  モデル名です。
  
  • image
  分類する画像ファイルです。対応しているフォーマットはJPEG、png、bmp、gif、tiffです。
  • サンプル
  ------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	文字列	○
candidates	object配列

• jobid
  画像分類の処理IDです。

• 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": "some-job-id",
   "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,
      }
    }
  }
]
}