注册⼀张⾃定义⼈脸。
接口说明
本接口一次仅能注册一张自定义人脸。
一个自定义人脸最多注册 10 张图像。
QPS 限制
本接口的单用户 QPS 限制为 100 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
mts:RegisterCustomFace |
create |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| CategoryId |
string |
是 |
⼈物库 ID，⽤于唯⼀标识⼀个⾃定义⼈物库。由调⽤者⽣成，调⽤者⾃⼰保证唯⼀性（请妥善保存此 ID 便于后续调用其他接口时使用）。 重要 不能与系统⼈物库 ID 相同，如果相同则默认使用系统人物库。最⻓⽀持 120 字符，不限中英文，不区分⼤⼩写。 |
CategoryId001-**** |
| PersonId |
string |
是 |
⼈物 ID，⽤于唯⼀标识⼀个⾃定义⼈物。由调⽤者⽣成，调⽤者⾃⼰保证唯⼀性（请妥善保存此 ID 便于后续调用其他接口时使用） 。 说明
最⻓⽀持 120 字符，不限中英文，不区分⼤⼩写，返回 FaceId 为 String 类型。 |
PersonId001-**** |
| ImageUrl |
string |
是 |
需要注册的⼈脸图⽚公网地址，图⽚中有且仅包含⼀张正脸。 |
http://example-****.jpeg |
| PersonName |
string |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回数据。 |
||
| FaceId |
string |
⼈脸 ID。 |
c6cc71cb44a9491093818faf9d60**** |
| RequestId |
string |
请求 ID。 |
91AEA76D-25B5-50DF-9126-AA6BB10FDAF4 |
示例
正常返回示例
JSON格式
{
"FaceId": "c6cc71cb44a9491093818faf9d60****",
"RequestId": "91AEA76D-25B5-50DF-9126-AA6BB10FDAF4"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 500 | InternalError | errorMsg:%s | 内部错误，偶发请重试。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。