返回首页

证件照生成-证件照制作

/api/v1/create 2 积分/次 运行中

【图文处理】【证件照制作】传入照片，接口自动按照证件规格进行剪裁、抠图、背景更换等，生成证件照片。

spec及bgColor参考附件
请求示例
request 
curl -X POST https://api.zhuimengapi.com/api/v1/create \
  -H "X-API-Key: RPA-xxxxxxxx"
  -d "base64=your_base64 \
  -d "url=your_url \
  -d "spec=your_spec \
  -d "bgColor=your_bgColor \
  -d "beautyDegree=your_beautyDegree \
  -d "size=your_size \
  -d "fileSize=your_fileSize \
  -d "dpi=your_dpi \
  -d "faceRatio=your_faceRatio \
  -d "faceCenterRange=your_faceCenterRange \
  -d "topEmpty=your_topEmpty"
import requests

url = "https://api.zhuimengapi.com/api/v1/create"
headers = {"X-API-Key": "RPA-xxxxxxxx"}
data = {
  "base64": "your_base64",
  "url": "your_url",
  "spec": "your_spec",
  "bgColor": "your_bgColor",
  "beautyDegree": "your_beautyDegree",
  "size": "your_size",
  "fileSize": "your_fileSize",
  "dpi": "your_dpi",
  "faceRatio": "your_faceRatio",
  "faceCenterRange": "your_faceCenterRange",
  "topEmpty": "your_topEmpty"
}

res = requests.post(url, data=data, headers=headers)
print(res.json())
const axios = require('axios');

axios.post("https://api.zhuimengapi.com/api/v1/create", {
    base64: "your_base64",
    url: "your_url",
    spec: "your_spec",
    bgColor: "your_bgColor",
    beautyDegree: "your_beautyDegree",
    size: "your_size",
    fileSize: "your_fileSize",
    dpi: "your_dpi",
    faceRatio: "your_faceRatio",
    faceCenterRange: "your_faceCenterRange",
    topEmpty: "your_topEmpty"
}, {
  headers: { "X-API-Key": "RPA-xxxxxxxx" }
}).then(res => console.log(res.data));
响应示例
response.json 
{
    "code": 0,
    "msg": "返回码对应描述",
    "taskNo": "本次请求号",
    "data": {
        "result": "证件照图片URL，有效期1天，请尽快下载保存",
        "base64": "证件照图片base64编码",
        "size": []
    }
}
接口信息
请求地址 https://api.zhuimengapi.com/api/v1/create
请求方式 POST
Content-Type application/x-www-form-urlencoded
鉴权方式 X-API-Key: RPA-xxxxxxxx
请求参数
base64 string
照片base64串，base64、url必须提供一个，优先级：base64 > url
url string
照片url，base64、url必须提供一个，优先级：base64 > url
spec string
证件照规格ID，见spec及bgColor参考
bgColor string
证件照颜色值: blue, red, white等值，或者以井号开始的16进制颜色值：#FF0000，见spec及bgColor参考
beautyDegree string
美颜级别，浮点型，如1.5，取值范围[1.0-5.0]，超出范围后的值无效。主要调节了脸部黑白平衡
size string
证件照像素尺寸，格式:"宽x高"（中间分隔符为小写字母x），比如"480x640"。为了避免和spec内定的像素大小冲突，使用本参数的同时，需要将spec设置为"12"
fileSize string
证件照图片的文件大小，如果期望证件照图片的文件大小（kb）在一定的限制范围内，可以设置这个值，值的单位为kb，格式为："最小值,最大值"，比如"10,100"表示希望返回的证件照文件大小在10-100kb之间；说明：该参数的单位为kb，而不是字节，如果文件大小设置不合理，比如过大或者过小，返回的文件大小有可能不在设定范围内
dpi string
返回的证件照分辨率，如果不设置该值，服务端会给出默认配置，一般返回300dpi的图片，个别证件照规格会返回350dpi的图片
faceRatio string
证件照中人脸占比参数，浮点类型，取值范围（0-1.0），不设置则服务端会给出默认配置，一般为0.5，个别证件照规格为0.4，如果觉得返回的人脸过大或者过小，可以自行调节该值
faceCenterRange string
脸部中心高度在证件照中的位置，浮点类型，取值范围（0-1.0），默认值为0.45；这个参数可以决定人脸在证件照所处于的高度
topEmpty string
用来约定生成证件照中，头顶距离照片顶部的距离范围，格式为"最小值,最大值"（使用英文字母逗号分隔），单位为像素，比如期望生成的证件照，人的头顶留空最少10个像素，最多30个像素，可以给出值"10,30"。注意不能两个值都设置为0，最大值必须大于最小值，最大值不能大于等于证件照的高度。当这个值不设置时，不做头顶留空的判断。人脸在证件照中的高度位置定位原则说明：先根据face_center_y（默认值为0.45）来定位人脸高度位置，然后对比top_empty（如有设置）参数，调整人脸位置，使其符合top_empty要求，最后还会判断人体底部是否可能悬空（原图人像高度不够时可能会发生这个问题），如果出现悬空的现象，则需要将人像向下移动至不悬空的位置
返回字段
code int 必填
返回码，详见返回码说明
msg string 必填
返回码对应描述
taskNo string 必填
本次请求号
data object 必填
返回数据
result string 必填
证件照图片URL，有效期1天，请尽快下载保存
base64 string 必填
证件照图片base64编码
size array 必填
证件照尺寸[宽, 高]
  • 200请求成功
  • 401API Key 无效或已过期，请检查密钥是否正确
  • 402余额不足，请充值后再试
  • 403IP 地址不在允许范围内或被限制访问
  • 404接口路由不存在，请检查接口地址
  • 429请求频率超限，请稍后再试
  • 500服务器内部错误，请联系技术支持
  • 502接口异常，或者传参错误，请联系技术支持
请求地址 https://api.zhuimengapi.com/api/v1/create
请求方式 POST
Content-Type application/x-www-form-urlencoded
鉴权 Header X-API-Key
Params Body
Params GET 请求只通过 URL 查询参数发送
Body 表单模式 POST + application/x-www-form-urlencoded 使用表单键值对请求体

快速信息

接口路由create
接口分类图片处理
请求方式POST
计费方式2 积分/次
频率限制不限制
认证方式X-API-Key
接口提供官方接口

如何调用

  1. 注册/登录本站账号
  2. 前往用户中心 → API密钥 ，创建一个密钥
  3. 在请求头添加 X-API-Key 携带密钥即可调用
  4. 每次成功调用将扣除 2 积分
前往创建 API 密钥