顔データを追加

post https://anysee.ap-northeast-1.cloud.japancv.co.jp/api/v1/entities/faces

顔検索のため、顔データを追加します

Responses

Response body

object

uuid

string

required

顔データを指定するための一意のID

model

string

required

length between 1 and 255

画像から特徴を抽出するために使用される画像認識モデル

JCV_FACE_K25000 JCV_FACE_J10000

collection

string

required

length ≤ 255

データ管理用の仮想データパーティション

key

string

required

length ≤ 255

ユーザー定義のキー。その一意性は本サービスによって保証されません。

metadata

array of objects

required

length ≤ 10

ユーザー定義のメタデータリスト

metadata*

object

name

string

required

length between 1 and 255

メタデータの名前。次の文字列値は予約されており、使用できません。id、instanceId、model、collection、key、createdAt、updatedAt、expiresAt。

type

string

required

length between 1 and 255

メタデータの型

string integer boolean float

value

required

メタデータの値；型と一致する必要があります

rotated

integer

アップロードされた画像の回転角度を示します。autoRotateがtrueの場合にのみレスポンスされます
コード | 回転角度
--- | ---
0 | 回転無し
1 | 反時計回りに90°回転
2 | 反時計回りに180°回転
3 | 反時計回りに270°回転

1 2 3

details

object

処理されたの顔データの詳細情報

position

object

処理された顔データの顔枠の位置情報

angle

object

処理された顔データの角度情報

landmarks

array of objects

処理された顔データのランドマーク座標リスト

landmarks

object

int32

required

ランドマークポイントのx座標

int32

required

ランドマークポイントのy座標

quality

object

処理された顔データの品質情報

attributes

object

処理された顔データの属性情報

createdAt

date-time

required

顔データが追加されたときのUTC時刻

updatedAt

date-time

required

顔データが更新されたときのUTC時刻

expiresAt

date-time

required

顔データ有効期限が切れるUTC時刻；最大値は3000-01-01T00:00:00Z；有効期限が切れの顔データは1時間以内に削除されます

Language

Credentials

Header

URL


xxxxxxxxxx
20
1
curl --request POST \
2
     --url https://anysee.ap-northeast-1.cloud.japancv.co.jp/api/v1/entities/faces \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "model": "JCV_FACE_K25000",
8
  "ttl": -1,
9
  "image": {
10
    "autoRotate": false,
11
    "returnDetails": {
12
      "position": false,
13
      "angle": false,
14
      "landmarks": false,
15
      "quality": false,
16
      "attributes": false
17
    }
18
  }
19
}
20
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201追加のリクエストは成功しました。その結果、新しい顔のデータが追加されました。

400構文が正しくないため、サーバーはリクエストを理解できません。

401リクエストには、認証ヘッダーフィールドを含むユーザー認証情報が必要です。

405リクエストHTTPメソッドは無効になっており、そのリソースには使用できません。

413リクエスト本文は、サーバーによって定義された制限よりも大きいです。（画像ファイルは5MB以下）

414クライアントがリクエストしたURIがサーバーの処理制限よりも大きいです。（8k）

415リクエストのコンテンツタイプのメディアタイプがサーバーでサポートされていません。

429ユーザーが指定された時間内に送信したリクエストが多すぎます。（プランの制限を参照してください）

431ヘッダーフィールドがサーバーの処理制限よりも大きいです。（25KB）

500サーバーで予期しない状態が発生したため、サーバーは要求を実行できません。

502サーバーは、リクエストを処理するために必要な応答を取得するためのゲートウェイとして機能しているときに、無効な応答を受け取りました。

503サーバーはリクエストを処理する準備ができていません。

504サーバーはゲートウェイとして機能しており、時間内にリクエストの応答を取得できません。