Pose Estimation

参考

Pose Estimation APIレファレンスの表示 >>
Pose Estimation説明書の表示 >>

概要

入力されたビジョンデータを通じて人を認識し、ポーズを分析するAPIサービスです。イメージの中の主要身体部位(18個)の座標と正確度の値を取得できます。

共通設定

Client IDは Naverクラウドプラットフォームコンソールでアプリケーションを登録して発行します。

  1. コンソールのAI·Application Service > AI·NAVER API > Applicationでアプリケーションを登録します。 詳しい方法の確認 >

  2. AI·Application Service > AI·NAVER API > Applicationで登録したアプリケーションを選択してClient IDとClient Secretの値を確認します。

  3. AI·Application Service > AI·NAVER API > Applicationの変更画面で Pose Estimationが選択されていることを確認します。選択されてない場合は429 (Quota Exceed)が発生するのでご注意をお願いします。

API URL

// オブジェクトディテクションAPI
https://naveropenapi.apigw.ntruss.com/vision-pose/v1/estimate

リクエストヘッダ

ヘッダ名 説明
X-NCP-APIGW-API-KEY-ID アプリケーションを登録する時に発行されたClient ID
X-NCP-APIGW-API-KEY-ID:{Client ID}
X-NCP-APIGW-API-KEY アプリケーションを登録する時に発行されたClient Secret
X-NCP-APIGW-API-KEY:{Client Secret}
Content-Type バイナリ伝送形式
Content-Type: multipart/form-data

エラーコード

共通エラー

{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}
HttpStatusCode ErrorCode ErrorMessage Description
400 100 Bad Request Exception protocol(https), endocing(UTF-8) など requestエラー
401 200 Authentication Failed 認証失敗
401 210 Permission Denied 権限なし
404 300 Not Found Exception 権限なし
429 400 Quota Exceeded Quota超過
429 410 Throttle Limited Rate超過
429 420 Rate Limited Rate超過
413 430 Request Entity Too Large conent-length超過 (10MB)
503 500 Endpoint Error エンドポイント連結エラー
504 510 Endpoint Timeout エンドポイント連結時間超過
500 900 Unexpected Error 例外処理がされてないエラー

APIエラー

HttpStatusCode ErrorCode ErrorMessage Description
400 ER01 image parameter is needed. imageパラメータが漏れています。
400 ER02 Failed to receive image content. イメージデータの受信に失敗しました。
400 ER03 Bad reqeust. 間違ったリクエストを受信しました。
400 ER04 Image size is too large. イメージのサイズが2MBを超えました。
ER11 Abnormal image format. 認識できないイメージデータが入力されました。
400 ER12 Abnormal image width v.s height ratio. イメージの幅が高さの4倍以上です。
400 ER13 Image width is to small. イメージの幅が50ピクセルより小さいです。
400 ER14 Image height is too small. イメージの高さが50ピクセルより小さいです。
400 ER15 Failed to analyze image. 分析できないイメージが入力されました。
400 ER21 Timeout error. サーバでイメージの分析を時間内に処理できませんでした。
400 ER22 Server is too busy. 現在、イメージ分析のリクエストが多いため処理できません。
500 ER92 Failed to generate valid json string. サーバで有効な形式のJSONデータを結果として作成できませんでした。
500 ER99 Internal server error. 内部サーバのエラーです。速やかに対応しますのでフォーラムまでお問い合わせください。

オペレーション