跳到正文

图片检测+更换底色

检测上传图片并更换指定底色,支持使用颜色名称或自定义颜色值。

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

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

返回格式:json

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

请求参数:

名称 必填 类型 说明
key 是 string 应用的key
image 是 string base64后的图片内容,大小不超过4M,分辨率不超过3072px。
color 否 string 颜色值(#FFFFFF);或颜色名称(blue、white、red、tint、grey、gradient、dark_blue、dark_red)
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/bg' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'key=YOUR_APP_KEY' \
  --data-urlencode 'image=BASE64_ENCODED_IMAGE' \
  --data-urlencode 'color=white' \
  --data-urlencode 'beauty=0'