Face Recognition - Add Face

post https://api.edenai.run/v2/image/face_recognition/add_face/

Available Providers

Provider	Version	Price	Billing unit
amazon	`boto3 1.26.8`	1.0 (per 1000 image)	1 image
facepp	`v3`	0.6 (per 1000 request)	1 request

time	status	user agent
Retrieving recent requests…

Loading…

Body Params

settings

string

Defaults to [object Object]

A dictionnary or a json object to specify specific models to use for some providers.
It can be in the following format: {"google" : "google_model", "ibm": "ibm_model"...}.

providers

array of strings

required

It can be one (ex: 'amazon' or 'google') or multiple provider(s) (ex: 'amazon,microsoft,google') that the data will be redirected to in order to get the processed results.
Providers can also be invoked with specific models (ex: providers: 'amazon/model1, amazon/model2, google/model3')

providers*

fallback_providers

array of strings

length ≤ 5

Defaults to

Providers in this list will be used as fallback if the call to provider in providers parameter fails.
To use this feature, you must input only one provider in the providers parameter. but you can put up to 5 fallbacks.

They will be tried in the same order they are input, and it will stop to the first provider who doesn't fail.

Doesn't work with async subfeatures.

fallback_providers

response_as_dict

boolean

Defaults to true

Optional : When set to true (default), the response is an object of responses with providers names as keys :

{"google" : { "status": "success", ... }, }

When set to false the response structure is a list of response objects :

[{"status": "success", "provider": "google" ... }, ].

attributes_as_list

boolean

Defaults to false

Optional : When set to false (default) the structure of the extracted items is list of objects having different attributes :

{'items': [{"attribute_1": "x1","attribute_2": "y2"}, ... ]}

When it is set to true, the response contains an object with each attribute as a list :

{ "attribute_1": ["x1","x2", ...], "attribute_2": [y1, y2, ...]}

show_base_64

boolean

Defaults to true

show_original_response

boolean

Defaults to false

Optional : Shows the original response of the provider.

When set to true, a new attribute original_response will appear in the response object.

file

File to analyse in binary format to be used with content-type: multipart/form-data
Does not work with application/json !

file_url

uri | null

File URL to analyse to be used with with content-type: application/json.

Responses

Language

Credentials

Bearer

JWT


xxxxxxxxxx
12
1
curl --request POST \
2
     --url https://api.edenai.run/v2/image/face_recognition/add_face/ \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "response_as_dict": true,
8
  "attributes_as_list": false,
9
  "show_base_64": true,
10
  "show_original_response": false
11
}
12
'

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

application/json

200

400

403

404

500