在构建美妆电商、直播社交或医美预演应用时，实现高精度的面部轮廓编辑（Beautification / Liquify）是一项复杂的视觉工程。传统的 2D 图像拉伸容易导致透视畸变和背景扭曲。
我们通过其 YouCam API 开放的 AI 人脸识别 API，提供了一套基于深度学习的面部拓扑重塑方案。该 API 允许开发者通过参数化控制，在保留原始肤质纹理的前提下，实现亚像素级的五官微调。
一、 技术底层：3D 面部网格与非生成式变形场
与 AIGC（生成式 AI）通过像素合成改变容貌不同，玩美的 AI 人脸识别技术 采用的是结构化几何变形逻辑。
1. 2D/3D 混合关键点对齐
API 内部集成了高精度的人脸对齐算法，能够实时锁定面部关键特征点。即便输入图像存在偏头（Yaw）、俯仰（Pitch）或翻滚（Roll）等姿态偏差，算法也能通过 3D 模型映射，确保重塑参数沿面部生物结构线进行位移，从而避免产生非自然的“液化”感。
2. 细粒度的参数矩阵
API 文档定义了多维度的控制变量，支持对特定区域进行解耦调整：
l Face Contouring: 涵盖 face_slimming（瘦脸）、下颌线颧骨优化及下巴比例调整。
l Ocular Reshaping: 包含 eye_enlarging（大眼）及眼距、眼角角度的微调。
l Nasal Refinement: 提供对 nose_wing（鼻翼）、鼻梁高度及鼻尖形态的精确控制。
l Lip Refinement: 提供对唇形大小、唇形厚度及高度的微调。
二、 API 集成规范与请求流程
我们的 YCE API 采用标准 RESTful 架构，具有极低的集成门槛和高扩展性。
1. 核心请求结构 (Request Payload)
开发者通过 reshape_types 对象传递各维度的强度数值（通常范围为 0-100）。
/** * Perfect Corp. AI Face Reshape API 调用逻辑 * Endpoint: https://yce-api-01.makeupar.com/s2s/v2.0/file/face-reshape */const requestBody = { "image": "BASE64_ENCODED_STRING", // 待处理的原始图像数据 "version": "1.0", "source": "yco", "features": { "eye_size_left": 80, "eye_size_right": 80, "eye_width": 0, "eye_height": 0, "eye_distance": 0, "eye_angle": 0, "face_reshape_left": 0, "face_reshape_right": 0, "chin_reshape_left": 20, "chin_reshape_right": 20, "chin_length": 0, "face_width": -30, "cheekbones": 0, "jaw": 0, "lip_size": 10, "lip_width": 40, "lip_height_top": 10, "lip_height_bottom": 10, "lip_peak": -10, "nose_size": 30, "nose_lift": -20, "nose_bridge_width": 10, "nose_tip": -10, "nose_wing": 30, "nose_tip_width": 30 }, "global": { "skin_smooth_strength": 50, "skin_smooth_color_intensity": 50 } };
2. 异步调用示例 (JavaScript)
利用异步 fetch 模式，开发者可以轻松地将重塑功能嵌入到 Web 或小程序的前端流中。
async function applyFaceReshape() { const apiEndpoint = "https://yce-api-01.makeupar.com/s2s/v2.0/file/face-reshape "; const apiKey = "YOUR_PC_YCE_ACCESS_TOKEN"; try { const response = await fetch(apiEndpoint, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${apiKey}` }, body: JSON.stringify(requestBody) }); const result = await response.json(); // 响应结构解析：获取处理后的图像索引或 URL if (result.status === "success") { // output_mask_name 指向云端渲染后的结果图 const resultImageUrl = result.results.output_mask_name; document.getElementById('face-preview').src = resultImageUrl; } } catch (error) { console.error("AI Face Reshape API 调用失败:", error); }}
三、 技术亮点与工程实践建议
1. 算法鲁棒性与稳定性
我们的人脸识别 AI API 经过大规模数据集训练，对不同年龄、性别和族裔的面部特征具有极强的泛化能力。其非生成式特性确保了处理过程的确定性（Deterministic），这在医美咨询和专业美妆演示中至关重要。
2. 环境适应性
API 内部集成了自动光影平衡与噪声过滤。即是在弱光环境下采集的低质量图像，AI 也能通过关键点补足，维持重塑效果的边缘平滑度（Anti-aliasing）。
3. 数据隐私与合规
我们的 AI API 遵循数据最小化处理原则。面部影像仅在内存中进行即时推理，处理完成后自动销毁，不进行持久化存储，助力开发者轻松应对 GDPR 等隐私合规要求。
四、 总结
我们的 AI 人脸识别 API 为开发者提供了一个高性能的面部几何编辑引擎。通过简洁的 JSON 参数控制，技术团队可以快速在应用中部署专业级的虚拟塑形功能，显著提升产品的交互深度与视觉表现力。
集成资源：
l [官方 API 文档中心]: YouCam API
l [技术支持]: 申请测试账号并获取专属 Access Token
