头像抠图 API

优质

小牛编辑

133浏览

2023-12-01

利用人工智能技术全自动分割出照片中的头像，分割精度高，准确率高，速度快。发丝级抠图，对脸部、头发进行细粒度分析，实现发丝级的精细化分割效果。不论发型是披肩发，还是丸子头，都可以完整分割。非常适合在图像合成的场景中应用，比如：照片换头，POD个性化定制、大头照、手机壳卡通头像、制作专属表情包等。识别图像中的人体轮廓，与背景进行分离，返回分割后的Alpha图、前景人像图，适应多个人体，复杂背景，人体位置重叠、遮挡、背面、侧面等各类人体姿态，各种服装、发饰、帽子、眼镜、鞋包等衣着配饰。

模式一

返回二进制文件流

模式二

返回base64字符串

模式三

通过图片URL返回base64结果

抠图API调用示例代码

github地址: https://github.com/picup-shop

cURL
Python
PHP
Java
nodejs
.net
Objective-C

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
    -F 'file=@/path/to/file.jpg'     \
    -f 'https://picupapi.tukeli.net/api/v1/matting?mattingType=3&crop=true' \
    -o out.png

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
    -F 'file=@/path/to/file.jpg'     \
    -f 'https://picupapi.tukeli.net/api/v1/matting?mattingType=3&crop=true' \
    -o out.png

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
    -F 'file=@/path/to/file.jpg'     \
    -f 'https://picupapi.tukeli.net/api/v1/matting?mattingType=3&crop=true' \
    -o out.png

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
    -F 'file=@/path/to/file.jpg'     \
    -f 'https://picupapi.tukeli.net/api/v1/matting?mattingType=3&crop=true' \
    -o out.png

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
    -F 'file=@/path/to/file.jpg'     \
    -f 'https://picupapi.tukeli.net/api/v1/matting?mattingType=3&crop=true' \
    -o out.png

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
    -F 'file=@/path/to/file.jpg'     \
    -f 'https://picupapi.tukeli.net/api/v1/matting?mattingType=3&crop=true' \
    -o out.png

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
    -F 'file=@/path/to/file.jpg'     \
    -f 'https://picupapi.tukeli.net/api/v1/matting?mattingType=3&crop=true' \
    -o out.png

API文档说明

接口描述

用户向服务请求获取某张图中的人物，服务器返回人物的PNG图片。

请求说明

请求URl: https://picupapi.tukeli.net/api/v1/matting?mattingType=3
请求方式: POST
返回类型: PNG图像
输入参数:
(1) 请求参数（Header）
参数参数类型描述
Content-Type string multipart/form-data
APIKEY string 您的专属API Key
(2) 请求参数（Body）
参数值必填
file 图片文件是
crop 是否裁剪至最小非透明区域，url参数，加在url后面，false不裁剪，true裁剪，不填写不裁剪否

返回说明

正常返回
直接返回content-type为image/png，图片处理后的二进制文件。

错误返回

{
  "code": 1001, //
  "data": null
  "msg": '余额不足',
  "time": 1590462453264
}

抠图API调用示例代码

github地址: https://github.com/picup-shop

cURL
Python
PHP
Java
nodejs
.net
Objective-C

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?mattingType=3&crop=true'

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?mattingType=3&crop=true'

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?mattingType=3&crop=true'

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?mattingType=3&crop=true'

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?mattingType=3&crop=true'

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?mattingType=3&crop=true'

curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?mattingType=3&crop=true'

API文档说明

接口描述

用户向服务请求获取某张图中的人物，服务器返回人物通过base64编码后的结果。

请求说明

请求URl: https://picupapi.tukeli.net/api/v1/matting2?mattingType=3
请求方式: POST
返回类型: PNG图像

输入参数:

(1) 请求参数（Header）

参数	参数类型	描述
Content-Type	string	multipart/form-data
APIKEY	string	您的专属API Key

(2) 请求参数（Body）

参数	值	必填
file	图片文件	是
crop	是否裁剪至最小非透明区域，url参数，加在url后面，false不裁剪，true裁剪，不填写不裁剪	否
faceAnalysis	人脸检测点信息，为true返回带人脸检测信息	否

返回说明

正常返回

{
    "code": 0,
    "data": {
    "imageBase64": "iVBORw0KGgo..." //返回图像的base64编码
    },
    "msg": null,
    "time": 1590462453264
}

返回带人脸检测信息

{
   "code": 0,
   "data":{
      "imageBase64":"iVBORw0KGgoAAAANSUhEUgAABqMAAAg3CAYAAAC7wX7xAAAgAElE....",
      "faceAnalysis":{
          "face_num": 1, //人脸数量
          "faces": [  //face_num*8 数组，含义为p1(x,y),p3(x,y),p2(x,y),p4(x,y)（参考图片）
               [
                   236.4606096446514,
                   497.67069862782955,
                   1492.7539091706276,
                   2050.210829436779,
                   236.4606096446514,
                   497.67069862782955,
                   1492.7539091706276,
                   2050.210829436779
               ]
           ]
          "point":[
             [
                [
                   213.5859375, //x轴点位
                   1035.0703125 //y轴点位
                ],
                [
                   221.80078125,
                   1219.904296875
                ]
                ......//一共返回68个点位,按数组索引值顺序请参考下方点位图片，数值默认为x,y
             ]
          ]
      }
   },
   "msg": null,
   "time": 1620798570850
}

点位图片

错误返回

{
  "code": 1001, //
  "data": null
  "msg": '余额不足',
  "time": 1590462453264
}

抠图API调用示例代码

github地址: https://github.com/picup-shop

cURL
Objective-c

curl -X GET --header 'Accept: application/json' \
    --header 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
    'https://picupapi.tukeli.net/api/v1/mattingByUrl?url=http%3A%2F%2Fdeeplor.oss-cn-hangzhou.aliyuncs.com%2Fupload%2Fimage%2F20200721%2F6ed6a205f75d4f4c88fb403700712191.jpg&mattingType=3'

curl -X GET --header 'Accept: application/json' \
    --header 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
    'https://picupapi.tukeli.net/api/v1/mattingByUrl?url=http%3A%2F%2Fdeeplor.oss-cn-hangzhou.aliyuncs.com%2Fupload%2Fimage%2F20200721%2F6ed6a205f75d4f4c88fb403700712191.jpg&mattingType=3'

API文档说明

接口描述

用户向服务请求获取某张图中的人物，服务器返回人物通过base64编码后的结果。

请求说明

请求URl: https://picupapi.tukeli.net/api/v1/mattingByUrl
请求方式: GET
返回类型: application/json

输入参数:

(1) 请求参数（Header）

参数	参数类型	描述
APIKEY	string	您的专属API Key

(2) URL参数

参数	值	必填
mattingType	抠图类型,1：人像，2：物体，3：头像，4：一键美化，6：通用抠图，11：卡通化，17: 卡通头像，18: 人脸变清晰， 19: 照片上色	是
crop	是否裁剪至最小非透明区域，url参数，加在url后面，false不裁剪，true裁剪，不填写不裁剪	否
url	图片的url地址	是
faceAnalysis	人脸检测点信息，为true返回带人脸检测信息	否

返回说明

正常返回

{
    "code": 0,
    "data": {
    "imageBase64": "iVBORw0KGgo..." //返回图像的base64编码
    },
    "msg": null,
    "time": 1590462453264
}

返回带人脸检测信息

{
   "code": 0,
   "data":{
      "imageBase64":"iVBORw0KGgoAAAANSUhEUgAABqMAAAg3CAYAAAC7wX7xAAAgAElE....",
      "faceAnalysis":{
          "face_num": 1, //人脸数量
          "faces": [  //face_num*8 数组，含义为p1(x,y),p3(x,y),p2(x,y),p4(x,y)（参考图片）
               [
                   236.4606096446514,
                   497.67069862782955,
                   1492.7539091706276,
                   2050.210829436779,
                   236.4606096446514,
                   497.67069862782955,
                   1492.7539091706276,
                   2050.210829436779
               ]
           ]
          "point":[
             [
                [
                   213.5859375, //x轴点位
                   1035.0703125 //y轴点位
                ],
                [
                   221.80078125,
                   1219.904296875
                ]
                ......//一共返回68个点位,按数组索引值顺序请参考下方点位图片，数值默认为x,y
             ]
          ]
      }
   },
   "msg": null,
   "time": 1620798570850
}

点位图片

错误返回

{
  "code": 1001, //
  "data": null
  "msg": '余额不足',
  "time": 1590462453264
}

价格说明

您可以通过在线充值付费方式，购买API调用点数。

查看价格列表

注意：API每次成功调用，消耗1点。

常见问题

Q：输入的图片格式有什么要求?
A：支持PNG、JPG、JPEG、BMP、GIF
Q：支持图片大小有限制吗?
A：目前上传的分辨率最大4096x4096像素，图片文件大小15MB以下