佐糖抠图API

智能检测图像中的前景主体并识别轮廓,实现精细化背景分割抠图,一键抠出人像、商品、动物、图章等。调用佐糖API,将AI抠图功能集成到您的网站、应用程序、软件中,轻松拥有像素级抠图服务!

抠图

AI抠图API文档 - 佐糖API (picwish.cn)

佐糖抠图API智能检测图像中的前景主体并识别轮廓,实现精细化背景分割抠图,一键抠出人像、物体、图章等前景图,适用于图像美化、电商海报、广告素材制作等诸多应用场景。

注意事项

  • 接口返回的链接一般有效期为 1 小时,请自行下载存储。
  • HTTP status 为 200表示http请求成功,并非抠图成功,详见状态码说明。
  • URL 作为参数传递时请遵守 URL 编码规范以防参数解析混乱。

同步和异步区别

为了满足用户高并发的需求,Picwish API支持消息队列异步任务请求,异步可以提高系统性能,提升吞吐量,保证了API的高可用。同步和异步的区别如下:

接口类型

请求方式

结果返回方式

优缺点

同步

发送一个请求后,需要等待服务器抠图,实时返回抠图结果

直接返回

在并发量大时,成功率低;网络传输较慢时,不稳定

异步

发送一个请求后,不需要实时等待服务器抠图,通过轮询主动获取抠图结果

通过轮询任务结果接口,查询识别结果

在并发量大时,成功率高; 在网络传输较慢或者不是特别稳定时,更稳定

接口描述

同步接口通过一个接口就可以实时返回抠图的结果(post请求)。

请求代码示例

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://techsz.aoscdn.com/api/tasks/visual/segmentation');
curl_setopt($curl, CURLOPT_HTTPHEADER, array(
      "X-API-KEY: {YOUR_API_KEY}",
      "Content-Type: multipart/form-data",
));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_POSTFIELDS, array('sync' => 1, 'image_file' => new CURLFILE("/path/to/image.jpg")));
$response = curl_exec($curl);
$result = curl_errno($curl) ? curl_error($curl) : $response;
curl_close($curl);
var_dump($result);

请求说明

a. 头部信息 (Header)

参数名称

参数类型

说明

X-API-KEY

string

您的专属API Key

b.请求包体(Body)

成功返回示例

  • 处理完成
{
    "status": 200,
    "message": "success",
    "data": {
        "completed_at": 1634641542,
        "created_at": 1634641541,
        "image": "https://wxtechsz.oss-cn-shenzhen.aliyuncs.com/tasks/output/segmentation/93a5e47b-a9c1-47ac-9b5e-22cb89f7d358-image.jpg?Expires=1634649061&OSSAccessKeyId=LTAI5tAmwVun6oc2TY8t4yWf&Signature=qkBkSu/Sc6uNaQeAEFJZP4ZHNew%3D",
        "mask": "https://wxtechsz.oss-cn-shenzhen.aliyuncs.com/tasks/output/segmentation/93a5e47b-a9c1-47ac-9b5e-22cb89f7d358-mask.jpg?Expires=1634649061&OSSAccessKeyId=LTAI5tAmwVun6oc2TY8t4yWf&Signature=sB0sFX8%2BlwPZvWcM3wGgEW0cnGI%3D",
        "output_type": 1,
        "processed_at": 1634641542,
        "progress": 100,
        "return_type": 1,
        "state": 1,
        "task_id": "5d7a8bb7-97aa-4e57-a22d-7620b08ded8e",
        "type": "auto"
    }
}

错误返回示例

  • 请求失败
{
    "status": 400,
    "message": "Invalid task type"
}
  • 处理失败
{
    "status": 200,
    "message": "success",
    "data": {
        "created_at": 1634888778,
        "processed_at": 1634888779,
        "progress": 0,
        "state": -1,
        "task_id": "fb5ce70b-a5eb-47d8-bf21-185d9f7ebe0e"
    }
}

返回字段说明

状态码说明

status代表的是Http响应状态码,只能判断这次请求是否成功,不能判断这次抠图是否成功。 请根据state的值来判断抠图结果,轮询抠图结果时,当state=1(抠图成功)或者state<0(抠图失败),就可以退出轮询。

判断步骤:

  • 1、通过status判断请求是否成功,status=200为成功,其他为失败
  • 2、通过state来判断抠图是否成功,state=1为抠图成功

AI抠图API文档 - 佐糖API (picwish.cn)

识别多种图像类型,应用场景丰富

顶级的算法团队,超过5000万张各类图形图片不断地测试训练,对发丝、高度镂空主体、复杂背景等都有很好的效果

  • 通用抠图
    复杂背景精准识别,无需手动选区操作
  • 人像抠图
    达到发丝级抠图效果,处理人像细节毫不含糊
  • 物品抠图
    精确识别物品主体轮廓,适应复杂背景与光线
  • 图形抠图
    平滑的边缘处理与镂空抠图,达到令人惊叹效果

API接口

快速识别图片中的人像、物品、和图章等主体,精准与背景进行分割。只要一键调用API接口,即可获得抠图服务,为企业或个人提升效率。

免费接入