登录
目录
当前位置： 首页 > 文档资料 > 皮卡智能 一键抠图神器 API 文档 >

人像抠图 API

优质
小牛编辑
139浏览
2023-12-01

利用人工智能技术全自动分割出照片中的人像，分割精度高，准确率高，速度快。 发丝级抠图，对脸部、头发进行细粒度分析，实现发丝级的精细化分割效果。不论发型是披肩发，还是丸子头，都可以完整分割。非常适合在图像合成的场景中应用，比如：证件照、职业装、学籍照、电商服饰、明星海报、女装、欧美时尚等。 识别图像中的人体轮廓，与背景进行分离，返回分割后的前景人像图，适应多个人体，复杂背景，人体位置重叠、遮挡、背面、侧面等各类人体姿态，各种服装、发饰、帽子、眼镜、鞋包、手机等衣着随身配饰。

模式一

返回二进制文件流

模式二

返回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=1' \
    -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=1' \
    -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=1' \
    -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=1' \
    -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=1' \
    -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=1' \
    -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=1' \
    -o out.png

API文档说明

接口描述

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

请求说明

  • 请求URl: https://picupapi.tukeli.net/api/v1/matting
  • 请求方式: POST
  • 返回类型: PNG图像
  • 输入参数:

    (1) 请求参数（Header）

    参数参数类型描述
    Content-Typestringmultipart/form-data
    APIKEYstring您的专属API Key

    (2) 请求参数（Body）

    参数值必填
    file图片文件是
    crop是否裁剪至最小非透明区域，url参数，加在url后面，false不裁剪，true裁剪，不填写不裁剪否
    bgcolor填充背景色，url参数，加在url后面，十六进制大小RGB颜色，如FFFFFF，不填写不填充背景色否

返回说明

  • 正常返回

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

  • 错误返回application/json格式的字符串 返回示例
    {
  "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?crop=true'
  • curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?crop=true'
  • curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?crop=true'
  • curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?crop=true'
  • curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?crop=true'
  • curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?crop=true'
  • curl -H 'APIKEY: INSERT_YOUR_API_KEY_HERE' \
     -F 'file=@/path/to/file.jpg'     \
     -f 'https://picupapi.tukeli.net/api/v1/matting2?crop=true'

API文档说明

接口描述

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

请求说明

  • 请求URl: https://picupapi.tukeli.net/api/v1/matting2
  • 请求方式: POST
  • 返回类型: PNG图像
  • 输入参数:

    (1) 请求参数（Header）

    参数参数类型描述
    Content-Typestringmultipart/form-data
    APIKEYstring您的专属API Key

    (2) 请求参数（Body）

    参数值必填
    file图片文件是
    crop是否裁剪至最小非透明区域，url参数，加在url后面，false不裁剪，true裁剪，不填写不裁剪否
    bgcolor填充背景色，url参数，加在url后面，十六进制大小RGB颜色，如FFFFFF，不填写不填充背景色否
    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=1'
  • 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=1'

API文档说明

接口描述

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

请求说明

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

    (1) 请求参数（Header）

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

    (2) URL参数

    参数值必填
    mattingType抠图类型,1：人像，2：物体，3：头像，4：一键美化，6：通用抠图，11：卡通化，17: 卡通头像，18: 人脸变清晰， 19: 照片上色是
    crop是否裁剪至最小非透明区域，url参数，加在url后面，false不裁剪，true裁剪，不填写不裁剪否
    bgcolor填充背景色，url参数，加在url后面，十六进制大小RGB颜色，如FFFFFF，不填写不填充背景色否
    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
}
免责声明： 以上内容版权归原作者所有，如有侵犯您的原创版权请告知，我们将尽快删除相关内容。感谢每一位辛勤著写的作者，感谢每一位的分享。
@小牛知识库 xnip.cn