返回首页

证件照生成-证件照制作

/api/v1/create 2 积分/次（约 ¥0.1/次） 运行中

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

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 请求成功返回字段以本接口的响应示例和实际结果为准，部分接口不包含 code 字段。 按接口规则计费
  • 400 参数或业务错误请求参数无效时返回安全、明确的修正提示。 不扣费
  • 401 API Key 无效密钥缺失、格式错误、无效或已经过期。 不扣费
  • 402 账户余额不足请充值后重试；本次请求不会进入接口处理。 不扣费
  • 403 访问被拒绝IP 规则限制，或当前账户无权调用仅限 VIP 的接口。 不扣费
  • 404 接口路由不存在请检查请求地址中的 API 路由是否正确。 不扣费
  • 405 请求方法不支持请按照接口文档使用允许的 GET 或 POST 方法，并查看 Allow 响应头。 不扣费
  • 413 请求体过大单次请求最大允许 20MB。 不扣费
  • 429 请求频率超限请根据 Retry-After 响应头稍后重试。 不扣费
  • 500 系统服务异常请稍后重试；持续出现时请向技术支持提供 request_id。 不扣费
  • 502 接口服务暂时不可用接口处理异常或暂时不可用，请稍后重试。 不扣费
  • 503 系统服务暂时不可用服务正在恢复，请稍后重试。 不扣费
错误响应示例 使用 request_id 查询对应调用日志 
{
  "code": 400,
  "message": "请输入有效的身份证号码",
  "data": null,
  "request_id": "1-xxxxxxxx",
  "time": "2026-07-29 12:00:00"
}
请求地址 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 积分/次（约 ¥0.1/次）
频率限制不限制
认证方式X-API-Key
接口提供官方接口

如何调用

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