调用RegisterCustomFace注册⼀张⾃定义⼈脸。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | RegisterCustomFace |
操作接口名,系统规定参数。取值:RegisterCustomFace。 |
CategoryId | String | 是 | xxCategoryIdxx |
⼈物库ID,⽤于唯⼀标识⼀个⾃定义⼈物库 由调⽤者⽣成,调⽤者⾃⼰保证唯⼀性 注意不能与系统⼈物库ID相同 (最⻓⽀持120字符,不限中英文,不区分⼤⼩写。)。 |
ImageUrl | String | 是 | http://xxxxx.jpeg |
需要注册的⼈脸图⽚公网地址,图⽚中有且仅包含⼀张正脸。 |
PersonId | String | 是 | xxPersonIdxx |
⼈物ID,⽤于唯⼀标识⼀个⾃定义⼈物 由调⽤者⽣成,调⽤者⾃⼰保证唯⼀性 (最⻓⽀持120字符,不限中英文,不区分⼤⼩写)返回FaceId为String。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
FaceId | String | 150968 |
⼈脸ID |
RequestId | String | D127C68E-F1A1-4CE5-A874-8FF724889585 |
请求ID |
示例
请求示例
http(s)://[Endpoint]/?Action=RegisterCustomFace
&CategoryId=xxCategoryIdxx
&ImageUrl=http://xxxxx.jpeg
&PersonId=xxPersonIdxx
&<公共请求参数>
正常返回示例
XML
格式
<RegisterCustomFaceResponse>
<FaceId>150968</FaceId>
<RequestId>D127C68E-F1A1-4CE5-A874-8FF724889585</RequestId>
</RegisterCustomFaceResponse>
JSON
格式
{
"RegisterCustomFaceResponse": {
"FaceId": 150968,
"RequestId": "D127C68E-F1A1-4CE5-A874-8FF724889585"
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
500 | InternalError | errorMsg:%s | 内部错误,偶发请重试。 |
400 | InvalidParameter | errorMsg:%s | 请求参数错误。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交