# 头像分割-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 失败原因
最后更新时间: 4/23/2024, 5:08:13 PM