Zuimei Zjz Api — Zuimei Zjz API

最美证件照 API 技能

让 AI 助手调用最美证件照的图像处理 API。

官网：https://zuimei.huipAI.vip

触发条件 (Gate)

当用户提到以下关键词时触发此技能：

证件照相关：

证件照、一寸照、二寸照、护照照、签证照、驾照照、身份证照 蓝底、红底、白底、渐变背景 制作证件照、生成证件照

抠图相关：

抠图、抠人像、去背景、透明背景、移除背景、消除背景 人像分离、背景分离

换背景相关：

换背景、改背景色、换底色、改底色、背景颜色

增强修复相关：

照片修复、模糊修复、变清晰、增强、画质提升 老照片修复、模糊照片

排版相关：

排版照、打印排版、冲印排版、6寸照、5寸照

编辑相关：

改尺寸、调大小、转换格式、改DPI、裁剪尺寸 安全配置 API 密钥处理

环境变量（推荐）：

导出 ZUIMEI_API_KEY="your_API_key" 导出 ZUIMEI_SECRET_KEY="your_secret_key"

安全要求：

密钥存储：API 密钥应存储在环境变量或安全的密钥管理系统中，禁止硬编码 传输安全：所有 API 请求必须使用 HTTPS 签名验证：每次请求必须携带有效的 v2 签名 密钥轮换：定期更换 API 密钥，发现泄露立即重置 权限控制：不同 API 密钥可配置不同的调用权限和配额

签名说明：

使用 HMAC-SHA256 算法 签名字符串格式：{method}\n{url}\n{timestamp}\n{nonce}\n{content_sha256} 时间戳有效期：5 分钟 Nonce 防重放：5 分钟内有效 API 端点 能力 API 端点 说明 一键证件照 /API/v1/photo/id-photo 完整证件照制作流程 智能抠图 /API/v1/segment/portrAIt 人像抠图，生成透明 PNG 换背景色 /API/v1/segment/background 替换背景颜色，支持渐变和多色 人脸增强 /API/v1/photo/enhance 修复模糊、提升清晰度 排版照 /API/v1/photo/layout 生成打印排版照 图片编辑 /API/v1/photo/edit 尺寸调整、格式转换 使用场景

• 证件照制作

用户需要制作证件照（一寸、二寸、护照照等）

调用 /API/v1/photo/id-photo 支持多种背景色、可选美颜

• 人像抠图

用户需要将人物从背景中分离

调用 /API/v1/segment/portrAIt 生成透明背景 PNG

• 换背景色

用户需要更换照片背景颜色

调用 /API/v1/segment/background 支持纯色、渐变、多色输出

• 照片修复

用户有模糊照片需要修复

调用 /API/v1/photo/enhance 人脸增强 + 超分辨率

• 打印排版

用户需要将证件照排版打印

调用 /API/v1/photo/layout 生成 6 寸/5 寸/A4 排版照

• 图片编辑

用户需要调整图片尺寸、格式

调用 /API/v1/photo/edit 调整尺寸、DPI、格式转换

快速开始

• 获取 API 密钥

在平台注册账号，获取：

API_key: API Key ID（如 ak_xxxx） secret_key: 密钥（用于签名）

• 签名认证

所有请求需要通过 v2 签名认证：

导入 hmac 导入 哈希lib 导入 time 导入 secrets

def 生成_签名ature(method, url, timestamp, nonce, content_sha256, secret_key): """生成 v2 签名""" 签名_str = f"{method}\n{url}\n{timestamp}\n{nonce}\n{content_sha256}" return hmac.new( secret_key.encode(), 签名_str.encode(), 哈希lib.sha256 ).hexdigest()

def build_content_sha256(fields: dict) -> str: """计算内容摘要""" canonical_lines = [] for key in 排序ed(fields.keys()): value = fields[key] if value is None: continue if isinstance(value, bool): value = "true" if value else "false" canonical_lines.应用end(f"{key}={value}") canonical_body = "\n".join(canonical_lines) return 哈希lib.sha256(canonical_body.encode()).hexdigest()

def calculate_image_sha256(file_bytes: bytes) -> str: """计算图片 SHA256""" return 哈希lib.sha256(file_bytes).hexdigest()

• 发送请求

def call_API(API_key, secret_key, 端点, files=None, data=None): """调用 API""" base_url = "https://idphoto.huipAI.vip" timestamp = str(int(time.time())) nonce = secrets.令牌_hex(16)

# 计算内容摘要 fields = {} if files and "image" in files: file_bytes = files["image"][1] fields["image"] = calculate_image_sha256(file_bytes) if data: fields.更新(data)

content_sha256 = build_content_sha256(fields)

# 生成签名 签名ature = 生成_签名ature( method="POST", url=端点, timestamp=timestamp, nonce=nonce, content_sha256=content_sha256, secret_key=secret_key )

# 发送请求 headers = { "X-API-Key": API_key, "X-Timestamp": timestamp, "X-Nonce": nonce, "X-签名ature": 签名ature, "X-Content-SHA256": content_sha256, "X-签名-Version": "v2" }

响应 = 请求s.post( f"{base_url}{端点}", files=files, data=data, headers=headers )

return 响应.json()

API 详细说明

详见 API.md

示例代码

详见 examples/ 目录

注意事项 时间戳有效期：请求时间戳与服务器时间差不超过 5 分钟 Nonce 防重放：每个 nonce 只能使用一次，5 分钟内有效 图片来源：支持 image 文件上传或 image_base64 编码 计费：部分 API 收费，详见各 API 说明