请求URL:http(s)://api.shiliuai.com/api/id_photo/v1/couple
请求方式:POST
返回类型:JSON
参数 | 类型 | 说明 |
---|---|---|
Content-type | string | application/json |
APIKEY | string | 您的API KEY |
分类 | 参数 | 是否必填 | 类型 | 说明 |
---|---|---|---|---|
图片 | ||||
base64 | 必须填写其中之一 | string | base64编码的图片文件(小于20M),需要传入base64或者id | |
id | string | 图片id,对于已经请求过的图片,如果需要改变水印,尺寸,颜色等参数,使用id而无需再上传base64 | ||
尺寸 | ||||
dpi | 否 | int | 生成证件照的dpi,默认为300 | |
pxWidth | 否 | int | 生成证件照的宽度(像素),可传入 (pxWidth, pxHeight) 或者 (mmWidth, mmHeight) 中的一对值,默认为 (295, 413) | |
pxHeight | 否 | int | 生成证件照的高度(像素) | |
mmWidth | 否 | int | 生成证件照的宽度(毫米) | |
mmHeight | 否 | int | 生成证件照的高度(毫米) | |
背景色 | ||||
changeBg | 否 | int | 0或1,是否抠图换背景,默认为1 | |
bgColor | 否 | string | 背景色的16进制表示,常用颜色有:白色:"FFFFFF",红色:"FF0000",蓝色:"438EDB",默认为白色 | |
美颜 | ||||
autoBright | 否 | int | 0或1,是否自动调光,默认为0 | |
brightFactor | 否 | float | [0, 1],调光系数,默认为0.5 | |
autoSmooth | 否 | int | 0或1,是否自动磨皮,默认为0 | |
smoothFactor | 否 | float | [0, 1],磨皮系数,默认为0.5 | |
autoThinFace | 否 | int | 0或1,是否自动瘦脸,默认为0 | |
thinFaceFactor | 否 | float | [0, 1],瘦脸系数,默认为0.5 | |
autoSharp | 否 | int | 0或1,是否自动锐化,默认为0 | |
sharpFactor | 否 | float | [0, 1],锐化系数,默认为0.5 | |
预览 | ||||
preview | 否 | int | 0或1,是否预览,预览有水印,不扣积分,默认为0 | |
watermarkID | 否 | string | 定制化水印id,默认用系统水印 | |
文件大小 | ||||
quality | 否 | int | 生成证件照的质量,[1, 100],越大生成的证件照文件越大,默认为92 | |
minFileSize | 否 | int | 生成证件照的最小文件大小,[0, inf],比如10240表示最小文件大小为10KB,只有当quality为空时起作用,默认为空 | |
maxFileSize | 否 | int | 生成证件照的最大文件大小,[0, inf],只有当quality为空时起作用,默认为空 | |
排版 | ||||
layout | 否 | int | 0或1,是否返回排版,默认为0 | |
layoutVertical | 否 | int | 0或1,返回横版或竖版排版,默认为横版 | |
layoutSize | 否 | string | "5inch"或"6inch",排版尺寸五寸或六寸,默认为"5inch" |
import requests import base64 import cv2 import json import numpy as np api_key = '******' # 你的API KEY file_path = '...' # 图片路径 with open(file_path, 'rb') as fp: photo_base64 = base64.b64encode(fp.read()).decode('utf8') url = 'https://www.shiliuai.com/api/id_photo/v1/couple' headers = {'APIKEY': api_key, "Content-Type": "application/json"} data = { "base64": photo_base64, } response = requests.post(url=url, headers=headers, json=data) response = json.loads(response.content) """ 成功:{'code': 0, 'msg': 'OK', 'msg_cn': '成功', 'id': image id, ''result_base64': result_base64} or 失败:{'code': error_code, 'msg': error_msg, 'msg_cn': 错误信息} """ result_base64 = response['result_base64'] file_bytes = base64.b64decode(result_base64) f = open('result.jpg', 'wb') f.write(file_bytes) f.close() image = np.asarray(bytearray(file_bytes), dtype=np.uint8) image = cv2.imdecode(image, cv2.IMREAD_UNCHANGED) cv2.imshow('result', image) cv2.waitKey(0)
$url = "https://www.shiliuai.com/api/id_photo/v1/couple"; $method = "POST"; $apikey = "******"; $header = array(); array_push($header, "APIKEY:" . $apikey); array_push($header, "Content-Type:application/json"); $file_path = "..."; $handle = fopen($file_path, "r"); $photo = fread($handle, filesize($file_path)); fclose($handle); $photo_base64 = base64_encode($photo); $data = array( "base64"=> $photo_base64, ); $post_data = json_encode($data); $curl = curl_init(); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_HTTPHEADER, $header); curl_setopt($curl, CURLOPT_POSTFIELDS, $post_data); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false); $response = curl_exec($curl); var_dump($response);
import java.io.*; import java.nio.file.Files; import java.nio.file.Paths; import java.util.Base64; import org.apache.http.HttpEntity; import org.apache.http.client.methods.CloseableHttpResponse; import org.apache.http.client.methods.HttpPost; import org.apache.http.entity.StringEntity; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.util.EntityUtils; import org.json.JSONObject; import org.opencv.core.Core; import org.opencv.core.Mat; import org.opencv.core.MatOfByte; import org.opencv.core.Size; import org.opencv.highgui.HighGui; import org.opencv.imgcodecs.Imgcodecs; import org.opencv.imgproc.Imgproc; public static void main(String[] args) { String api_key = "******"; // 你的API KEY String file_path = "..."; // 图片路径 String url = "https://www.shiliuai.com/api/id_photo/v1/couple"; try { byte[] fileBytes = Files.readAllBytes(Paths.get(file_path)); String photoBase64 = Base64.getEncoder().encodeToString(fileBytes); JSONObject data = new JSONObject(); data.put("base64", photoBase64); CloseableHttpClient httpClient = HttpClients.createDefault(); HttpPost httpPost = new HttpPost(url); httpPost.setHeader("APIKEY", api_key); httpPost.setHeader("Content-Type", "application/json"); StringEntity entity = new StringEntity(data.toString(), "UTF-8"); httpPost.setEntity(entity); CloseableHttpResponse response = httpClient.execute(httpPost); try { HttpEntity responseEntity = response.getEntity(); String responseString = EntityUtils.toString(responseEntity, "UTF-8"); JSONObject jsonResponse = new JSONObject(responseString); if (jsonResponse.getInt("code") == 0) { System.out.println("成功: " + responseString); String resultBase64 = jsonResponse.getString("result_base64"); byte[] resultBytes = Base64.getDecoder().decode(resultBase64); Files.write(Paths.get("result.jpg"), resultBytes); Mat mat = Imgcodecs.imdecode(new MatOfByte(resultBytes), Imgcodecs.IMREAD_UNCHANGED); HighGui.imshow("result", mat); HighGui.waitKey(); } else { System.out.println("失败: " + responseString); } } finally { response.close(); } } catch (IOException e) { e.printStackTrace(); } }
参数 | 说明 |
---|---|
code | 错误码 |
msg | 错误信息(英文) |
msg_cn | 错误信息(中文) |
id | 图片id,(当code==0时会有该返回值) |
result_base64 | 结婚照的base64编码,(当code==0时会有该返回值) |
layout_base64 | 排版的base64编码,(当code==0且请求参数layout==1时会有该返回值) |
错误码 | 说明 |
---|---|
0 | 成功 |
1 | 图片错误 |
2 | 抠图错误 |
3 | 服务器繁忙 |
4 | 参数错误,具体错误看msg或msg_cn |
6 | 未知错误 |
7 | 图片id无效,可能已过期 |
8 | 图片人脸数不是2 |
101 | API-KEY不正确 |
102 | 未知用户 |
103 | 积分已用完 |
104 | 扣除积分失败 |
证件照制作/检测接口(API)定义:采用自研深度学习算法与图像处理技术,包括人脸检测、人像裁剪、背景抠除、背景颜色替换、美颜、换衣服等功能,实现普通生活照变成结婚证件照功能。
支持各种程序和设备接入,包括小程序、APP、采集设备等,灵活适用于不同应用场景。
结婚证件照制作接口能够根据指定的要求自动生成符合标准的结婚证件照。其主要功能包括:
1.全规格支持:
尺寸:可自定义长宽定义和分辨率DPI。
颜色:支持纯色、渐变色或无背景色。
大小:可控制生成文件大小(KB)。
2.美颜:包括磨皮、瘦脸、调光、锐化等功能,确保照片达到最佳效果。
3.预览:提供加水印预览功能,让用户在生成证件照前能够预览效果。
4.排版打印:支持打印5寸和6寸相纸的排版照片打印。
API类型 | 价格说明 |
---|---|
结婚证件照API | 每次调用消耗一积分 |
如有问题联系右侧“客服” |