Face Registration

Create a person

Good to know: This API method allows your business to register a user and save their image with a unique identifier. The identifier would be used as a reference when making face recognition requests.

Create person

POST https://api.usetani.com/api/v0/person

Creates a new person.

Headers

Name	Type	Description
x-api-key*	string	Your API key
x-group-id*	string	Your group ID from the dashboard.

Request Body

Name	Type	Description
person_name*	string	The name of the person
client_id*	string	The unique ID of your user for reference.

200 Person created successfully

{
    "message":"Person created successfully",
    "person_details": {
        "person_id": "string",
        "person_name": "string",
        "client_id": "string",
    }
}

401 Unauthorized

{
    "detail": "API key/Group Id is missing"
}

500: Internal Server Error Server error

{
    // Response
}

400: Bad Request Identifier already exists with a different person.

{
    // Response
}

Add an image to identify a person

Good to know: This request collects the image provided and stores the vector representation in our database.

Add Image To Person

POST/api/v0/persons/{person_id}/image

Authorization

APIKeyHeaderAPIKeyHeader

Path parameters

person_id*Person Id

Body

multipart/form-data

image*Image

Response

200422

Successful Response

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('/api/v0/persons/{person_id}/image', {
    method: 'POST',
    headers: {
      "Content-Type": "multipart/form-data"
    },
    body: JSON.stringify({
      "image": "binary"
    }),
});
const data = await response.json();

Response

422

{
  "detail": [
    {
      "loc": [
        "text"
      ],
      "msg": "text",
      "type": "text"
    }
  ]
}