/faceset/create

Description

Create a faceset.

One Faceset may contains at most 10000 Faces
The app under developer status can  NOT create more than 5 faceset.

Parameter

 NameDescription
Required api_key Your registered API Key
  api_secret Your registered API Secret
Optional faceset_name Name of the faceset, which must be unique in one API Key. Any character except ^@,&=*'" is allowed (quotes for clarification), but the length should not exceed 255. If omitted, a random unique name would be given.
  face_id A comma-separated list of face ids, which would be added to the faceset.
  tag A string to be associated with this faceset, which does not need to be unique and can be used to store any information. Any character except ^@,&=*'" is allowed, the length must not exceed 255.

Return Values

FieldTypeDescription
added_face int The number of added face
tag string Tag associate with the faceset
faceset_id string Unique id of a faceset on Face++ platform
faceset_name string Name of the faceset

Parameter

https://apius.faceplusplus.com/v2/faceset/create?api_key=YOUR_API_KEY&api_secret=YOUR_API_SECRET&tag=demotest&faceset_name=NicolasCage

JSON Response

{
    "added_face": 0,
    "faceset_id": "c1e580c0665f6ed11d510fe4d194b37a", 
    "faceset_name": "NicolasCage",
    "tag": "demotest"
}

Error Code List

Error CodeHTTP Status CodeError Message
1001 500 INTERNAL_ERROR
1003 403 AUTHORIZATION_ERROR
1003 403 INSUFFICIENT_PRIVILEGE_OR_QUOTA_LIMIT_EXCEEDED
1004 400 MISSING_ARGUMENTS
1008 400 TOO_MANY_ITEMS_TO_ADD
1005 400 INVALID_ARGUMENTS
1006 403 ILLEGAL_USE_OF_DEMO_KEY
1202 502 SERVER_TOO_BUSY
1501 451 BAD_NAME
1502 452 BAD_TAG
1503 453 NAME_EXIST
Google+