# 头像分割-API接入
利用AI识别图片中的脸部，并自动提取，形成精准的像素级抠图。
# 任务创建
根据输入参数创建算法任务并返回任务id
# 请求地址
/v3/pic/hs/batch
# 请求参数
Method
post
Header
| Field | Required | Type | Value | Description |
|---|---|---|---|---|
| Content-Type | YES | string | application/json | |
| Authorization | YES | string | Basic xxxxxxxxx | 用户使用appkey和secret拼接出来的Basic base64(appkey:appsecret) |
Body
| Field | Required | Type | Value | Description |
|---|---|---|---|---|
| images | YES | string[] | 待处理图片，最多20张（oss uri, 可下载文件链接地址） | |
| priority | YES | integer | 优先级, 范围[0,9] |
示例代码
{
"images": ["pcloud/a.png","pcloud/b.png"],
"priority":1
}
# 输入文件限制
| 图片格式 | 图片体积 | 图片分辨率 | 图像纵横比 |
|---|---|---|---|
| PNG JPG JPEG BMP | 不超过50 MB | 大于256×256px，小于5000x5000px | 纵横比在4:1以内 |
# 返回数据
Body
| Field | Son Field | Required | Type | Value | Description |
|---|---|---|---|---|---|
| code | - | YES | number | 状态码 | |
| msg | - | YES | string | 请求信息 | |
| data | - | YES | object | 响应数据 | |
| - | task_id | YES | string | 任务id |
示例代码
{
"code": 0,
"msg": "",
"data": {
"task_id": "6a4eab77-be30-430a-bf0e-3048042a34ef"
}
}
# 结果获取
根据任务id 请求任务处理结果
# 请求地址
/v3/pic/hs/result/{task_id}
# 请求参数
Method
get
Header
| Field | Required | Type | Value | Description |
|---|---|---|---|---|
| Content-Type | YES | string | application/json | |
| Authorization | YES | string | Basic xxxxxxxxx | 用户使用appkey和secret拼接出来的Basic base64(appkey:appsecret) |
路径参数
| Field | Son Field | Required | Type | Value | Description |
|---|---|---|---|---|---|
| task_id | - | YES | string | 任务id |
# 返回数据
Body
| Field | Son Field | Grandson Field | Required | Type | Value | Description |
|---|---|---|---|---|---|---|
| code | - | - | YES | number | 状态码 | |
| msg | - | - | YES | string | 请求信息 | |
| data | - | - | YES | object | 响应数据 | |
| - | status | - | YES | string | 任务状态 状态：1- 等待中；2-进行中；3-任务完成；4-任务失败；5-任务关闭 6-任务超时 8-余额不足 | |
| - | wait_time | - | YES | string | 下一次请求前需要的等待时长，为s为单位 | |
| - | list | - | YES | object[] | 结果列表 | |
| - | - | image_result | YES | string | 处理后图片URL | |
| - | - | status | YES | string | 处理状态 | |
| - | - | reason | YES | string | 失败原因 |