任务：智能抠图

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data

image_file

file

必需

源图像文件（二进制），与 image_url 参数二选一

image_url

string

必需

源图像URL，与 image_file 参数二选一

示例:

https://p1-kling.klingai.com/bs2/upload-ylab-stunt/332e084d74c59da4056b7600c151d469.png

sync

enum<integer>

可选

是否等待结果就绪并立即返回（默认值：0）。如果设为1，API将会等待结果准备好后立即返回。如果设为0，需要通过任务查询接口获取结果。如果需要大批量请求建议设置为异步(0)。

枚举值:

01

默认值:

0

示例:

1

type

enum<string>

可选

前景类型：

空 = 自动检测前景类型。（默认）

"person" = 使用人作为前景。

"object" = 使用物品作为前景。

"stamp" = 使用图章作为前景。

枚举值:

留空，自动检测前景类型。person使用人作为前景。object使用物品作为前景。stamp使用图章作为前景。

output_type

enum<integer>

可选

图片返回选项：

1 = 同时返回图片和蒙版。
2 = 只返回图片。（默认选项）
3 = 只返回蒙版。

图片是前景提取处理的结果，通常是彩色图片，而蒙版代表用于提取的黑白区域。

枚举值:

123

默认值:

2

示例:

2

crop

enum<integer>

可选

是否裁剪至目标边缘:

0 = 返回原始图像大小。（默认选项）
1 = 裁剪至目标边缘。

枚举值:

01

默认值:

0

示例:

0

format

enum<string>

可选

图片格式：

png = 透明图片（默认选项）。
jpg = 默认白色背景的非透明图片。您可以使用bg_color参数设置背景颜色。

枚举值:

pngjpg

默认值:

png

示例:

png

bg_color

string

可选

添加纯色背景。此参数仅在格式设置为jpg时生效。可以为十六进制颜色代码（例如：81d4fa，ffffff）。如果未提供，JPG的默认背景颜色为白色。

callback_url

string

可选

回调通知地址：如若需要回调通知，可设置该参数，填写API通知url地址

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.pawmaas.com/task/pic/segmentation' \
--header 'Authorization: Bearer <token>' \
--form 'image_file=@""' \
--form 'image_url="https://p1-kling.klingai.com/bs2/upload-ylab-stunt/332e084d74c59da4056b7600c151d469.png"' \
--form 'sync="1"' \
--form 'type=""' \
--form 'output_type="2"' \
--form 'crop="0"' \
--form 'format="png"' \
--form 'bg_color=""' \
--form 'callback_url=""'

返回响应

🟢200成功

application/json

Body

status

integer

必需

data

object

必需

completed_at

integer

必需

created_at

integer

必需

download_time

integer

必需

err_info

string

必需

foreground_rect

object

必需

image

string

必需

image_height

integer

必需

image_width

integer

必需

output_type

integer

必需

processed_at

integer

必需

progress

integer

必需

result_type

string

必需

return_type

integer

必需

state

integer

必需

state_detail

string

必需

task_id

string

必需

time_elapsed

number

必需

type

string

必需

示例

成功示例1（sync=1）成功示例2（sync=0）

{
    "status": 200,
    "data": {
        "completed_at": 1742670627,
        "created_at": 1742670626,
        "download_time": 488,
        "err_info": "",
        "foreground_rect": {
            "x": 133,
            "y": 110,
            "width": 604,
            "height": 952
        },
        "image": "https://wxtechsz.oss-cn-shenzhen.aliyuncs.com/tasks/output/segmentation/3b950563-e53f-4036-a581-5ac04d0829b3-image.png?x-oss-credential=LTAI5tGjJnh66c1txANiRBQN/20250322/cn-shenzhen/oss/aliyun_v4_request&x-oss-date=20250322T191028Z&x-oss-expires=3600&x-oss-signature=67a3fda34dcf0827e9ec9eae3e84f134a59dedff406a4a79fa5b76bbe16a007c&x-oss-signature-version=OSS4-HMAC-SHA256",
        "image_height": 1152,
        "image_width": 864,
        "output_type": 2,
        "processed_at": 1742670626,
        "progress": 100,
        "result_type": "object",
        "return_type": 1,
        "state": 1,
        "state_detail": "Complete",
        "task_id": "3b950563-e53f-4036-a581-5ac04d0829b3",
        "time_elapsed": 384.54998779296875,
        "type": "auto"
    }
}