跳到正文

证件照检测+制作(无水印)

按指定规格检测并制作证件照,成功后直接返回无水印图片。

接口地址:https://api.zjzapi.com/idcardv5/all

请求方式:POST(application/x-www-form-urlencoded)

返回格式:json

接口费用:获取成功扣除0.6元

请求参数:

名称 必填 类型 说明
key 是 string 应用的key
item_id 是 int 规格id,《查看规格列表》
image 是 string base64后的图片内容,大小不超过8M。
colors 否 string 颜色名称(需根据每个规格支持情况进行填写),不填写返回所有底色
enhance 否 int 人像增强,默认已支持,不需要可传参数0
beauty 否 int 美颜,默认已支持,不需要可传参数0
whitening 否 int 美颜-美白等级:0-100,默认值60,beauty字段必须设置为1,该参数才会生效

返回参数:

名称 类型 说明
code int 状态码
msg string 返回说明
data array 数据集

JSON返回示例:


{
    "data": {
        "pic_id": "9244614",
        "list": {
             "white": "http://demo.com/pic/20200511/913191c8906ce81a2107d6ff5157c014/white.jpg"
        }
    },
    "code": 0,
    "msg": "success"
}

请求示例代码:

请替换占位值后在服务端运行。图片使用原始 Base64 字符串,由表单编码器处理特殊字符;不要手动重复 URL 编码。HTTP 成功后仍需检查业务 code。

# Bash / zsh,cURL 7.76+;Windows 可使用 Git Bash 或 WSL。
curl --fail-with-body --max-time 60 --request POST 'https://api.zjzapi.com/idcardv5/all' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'key=YOUR_APP_KEY' \
  --data-urlencode 'item_id=YOUR_ITEM_ID' \
  --data-urlencode 'image=BASE64_ENCODED_IMAGE' \
  --data-urlencode 'colors=white'