# AI抠图-API接入
利用AI识别图片中的主体，并自动提取，形成精准的像素级抠图。
# 任务创建
根据输入参数创建算法任务并返回任务id
# 请求地址
/v3/pic/fs/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以内 |
参数效果
| 请求编号 | mask_off | 参数效果 | 处理结果 |
|---|---|---|---|
| 1 | 0 | 返回一张原始的辛普森风格图片 |
# 返回数据
Body
| Field | Son Field | Required | Type | Value | Description |
|---|---|---|---|---|---|
| code | - | YES | number | 状态码, 490027:余额不足错误 | |
| msg | - | YES | string | 请求信息 | |
| data | - | YES | object | 响应数据 | |
| - | task_id | YES | string | 任务id |
示例代码
{
"code": 0,
"msg": "",
"data": {
"task_id": "fs-839a59db-55f4-4f53-8456-fd37e1e4d9fa"
}
}
# 结果获取
根据任务id 请求任务处理结果
# 请求地址
/v3/pic/fs/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 | 失败原因 | |
| - | - | mask_result | YES | string | 处理后maskURL | |
| - | reason | - | YES | string | 失败原因 |