姿勢推定
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をスコアの高い順にソートして配列で設定します。
- tag
分類した画像のタグです。 - id
分類した画像のidです。 - keyPoints 分類した画像の関節に関する情報です。
- Key Points object
JSONキー 値 name 文字列 x 実数 y 実数 score 実数 - name keyPoint の名前が表示されます。たとえば、nose などと表示されます。
- x
keyPoint の X 座標が表示されます。 - y
keyPoint の Y 座標が表示されます。 - score keyPointに対する適合度です。
なお、name
ではなく各keyPointの名前がそのままjsonキーとなりますのでご注意ください。
KeyPointは、nose, neck, shoulderRight , elbowRight , wristRight , shoulderLeft , elbowLeft , wristLeft , hipRight , kneeRight , ankleRight , hipLeft , kneeLeft , ankleLeft , eyeRight , eyeLeft , earRight , earLeft
となります。
candidates object
JSONキー | 値 | 必須 |
---|---|---|
tag | 文字列 | ○ |
id | 文字列 | ○ |
keyPoints | object配列 | 〇 |
サンプル
{
"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,
}
}
}
]
}