/faceset/create

描述

创建一个Faceset

一个Faceset最多允许包含10000个Face。
开发版最多允许创建5个Faceset。

参数

 参数名参数说明
必须 api_key App的Face++ API Key
  api_secret APP的Face++ API Secret
可选 faceset_name Faceset的Name信息,必须在App中全局唯一。Name不能包含^@,&=*'"等非法字符,且长度不得超过255。Name也可以不指定,此时系统将产生一个随机的name。
  face_id 一组用逗号分隔的face_id, 表示将这些Face加入到该Faceset中
  tag Faceset相关的tag,不需要全局唯一,不能包含^@,&=*'"等非法字符,长度不能超过255。

返回值说明

字段类型说明
added_face int 成功加入的face数量
tag string Faceset相关的tag
faceset_name string 相应Faceset的name
faceset_id string 相应Faceset的id

调用示例

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

JSON 示例

{
    "added_face": 1,
    "faceset_id": "c1e580c0665f6ed11d510fe4d194b37a", 
    "faceset_name": "NicolasCage",
    "tag": ""
}

错误列表

错误代码HTTP 状态代码错误信息
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