证件照

优质

小牛编辑

123浏览

2023-12-01

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

证件照API调用示例代码

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

Python
PHP
Java
Objective-c

import requests

url = 'https://picupapi.tukeli.net/api/v1/idphoto/printLayout'
apikey = '你的apikey'
headers={'APIKEY': apikey, "Content-type": "application/json"}
data = {
  "base64": "/9j/4AAQSkZJRgA...此处省略base64一万字，注意，有的人测试的时候使用在线base64转化工具，注意将data:image/jpg;base64,这部分字符串去除",
  "bgColor": "FFFFFF",
  "dpi": 300,
  "mmHeight": 35,
  "mmWidth": 25,
  "printBgColor": "FFFFFF",
  "printMmHeight": 210,
  "printMmWidth": 150
}
response=requests.post(url=url,headers=headers,json=data)
print(response.content)

import requests

url = 'https://picupapi.tukeli.net/api/v1/idphoto/printLayout'
apikey = '你的apikey'
headers={'APIKEY': apikey, "Content-type": "application/json"}
data = {
  "base64": "/9j/4AAQSkZJRgA...此处省略base64一万字，注意，有的人测试的时候使用在线base64转化工具，注意将data:image/jpg;base64,这部分字符串去除",
  "bgColor": "FFFFFF",
  "dpi": 300,
  "mmHeight": 35,
  "mmWidth": 25,
  "printBgColor": "FFFFFF",
  "printMmHeight": 210,
  "printMmWidth": 150
}
response=requests.post(url=url,headers=headers,json=data)
print(response.content)

import requests

url = 'https://picupapi.tukeli.net/api/v1/idphoto/printLayout'
apikey = '你的apikey'
headers={'APIKEY': apikey, "Content-type": "application/json"}
data = {
  "base64": "/9j/4AAQSkZJRgA...此处省略base64一万字，注意，有的人测试的时候使用在线base64转化工具，注意将data:image/jpg;base64,这部分字符串去除",
  "bgColor": "FFFFFF",
  "dpi": 300,
  "mmHeight": 35,
  "mmWidth": 25,
  "printBgColor": "FFFFFF",
  "printMmHeight": 210,
  "printMmWidth": 150
}
response=requests.post(url=url,headers=headers,json=data)
print(response.content)

import requests

url = 'https://picupapi.tukeli.net/api/v1/idphoto/printLayout'
apikey = '你的apikey'
headers={'APIKEY': apikey, "Content-type": "application/json"}
data = {
  "base64": "/9j/4AAQSkZJRgA...此处省略base64一万字，注意，有的人测试的时候使用在线base64转化工具，注意将data:image/jpg;base64,这部分字符串去除",
  "bgColor": "FFFFFF",
  "dpi": 300,
  "mmHeight": 35,
  "mmWidth": 25,
  "printBgColor": "FFFFFF",
  "printMmHeight": 210,
  "printMmWidth": 150
}
response=requests.post(url=url,headers=headers,json=data)
print(response.content)

API文档说明

请求说明

请求URl: https://picupapi.tukeli.net/api/v1/idphoto/printLayout
请求方式: POST
返回类型: json数据

输入参数:

(1) 请求参数（Header）

参数	参数类型	描述
Content-Type	string	application/json
APIKEY	string	您的专属API Key

(2) 请求参数（Body）

{
  base64 (string, required): 头像图片文件的base64 ,
  bgColor (string, required): 证件照背景色，格式为十六进制RGB， 如：3557FF ,
  bgColor2 (string, optional): 证件照渐变背景色（非必填），格式为十六进制RGB， 如：3557FF , 如果需要渐变色处理，填写此颜色，背景色会纵向从上到下bgColor渐变为bgColor2，
  dpi (integer, required): 证件照打印dpi, 一般为300 ,
  mmHeight (integer, required): 证件照物理高度，单位为毫米 ,
  mmWidth (integer, required): 证件照物理宽度，单位为毫米 ,
  printBgColor (string, required): 排版背景色，格式为十六进制RGB， 如：FFFCF9 ,
  printMmHeight (integer, required): 打印的排版尺寸，单位为毫米, 如果为0或小于证件照尺寸则不会进行打印排版，输出单张证件照 ,
  printMmWidth (integer, required): 打印的排版尺寸，单位为毫米, 如果为0或小于证件照尺寸则不会进行打印排版，输出单张证件照,
  dress(string, optional): 换装参数，为类型+换装编号格式，比如 man1 男士第一个换装图， woman3 女士第三个换装，child5 儿童第五个换装。
         换装需额外扣除一个点点数
}

换装样图参见：https://deeplor.oss-cn-hangzhou.aliyuncs.com/site/idphoto-dress.zip

DPI的说明与换算：

DPI是指打印分辨率，指的是打印机在每英寸可打印的像素点数，是衡量打印质量的一个重要标准。一般的打印机dpi为300，但是需要根据自己的照片打印机实际的DPI参数进行调整。
可通过以下公式进行简单换算：
像素 = 尺寸（毫米）* DPI / 25.4
尺寸（毫米）= 像素 * 25.4 / DPI

(3) 响应数据

{
  "code": 0,
  "data": {
    "idPhotoImage": 单个证件照的图片地址，url在十分钟内访问有效
    "printLayoutImage": 证件照打印排版的图片地址，url在十分钟内访问有效,如果不排版或者排版尺寸小于证件照尺寸，地址和证件照地址相同
    "idPhotoCount": 证件照排版数量,如果不排版或者排版尺寸小于证件照尺寸，输出0
  },
  "msg": null,
  "time": 1599644436677
}

价格说明

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

查看价格列表

注意：API每次成功调用，只需要证件照消耗1点；
证件照+智能打印排版，总共消耗2点；
证件照+换装，总共消耗2点；
证件照+智能打印排版+换装，总共消耗3点。

常见问题

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