跳到正文

证件照检测+自定义制作

检测上传图片,按自定义尺寸、底色、文件大小和分辨率制作证件照。

接口地址:https://api.zjzapi.com/idcardv3/diy

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

返回格式:json

接口费用:检测并制作成功扣除0.012 元,检测失败扣除0.006 元,若使用"美颜"功能将多扣除0.012元。

请求参数:

名称 必填 类型 说明
key 是 string 应用的key
image 是 string base64后的图片内容,大小不超过8M。
width_px 是 int 像素尺寸-宽,不超2000px
height_px 是 int 像素尺寸-高,不超2000px
color 是 string 颜色值(#FFFFFF);或颜色名称(blue、white、red、tint、grey、gradient、dark_blue、dark_red)
file_size_min 否 int 文件最小(kb),最小5kb
file_size_max 否 int 文件最大(kb),最大300kb
dpi 否 int 分辨率:默认为300
beauty 否 int 美颜:0=否,1=是,默认为0
whitening 否 int 美颜-美白等级:0-100,默认值50

返回参数:

名称 类型 说明
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/idcardv3/diy' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'key=YOUR_APP_KEY' \
  --data-urlencode 'image=BASE64_ENCODED_IMAGE' \
  --data-urlencode 'width_px=295' \
  --data-urlencode 'height_px=413' \
  --data-urlencode 'color=white' \
  --data-urlencode 'dpi=300'