📡 旷视五接口 — 前端接入说明

统一响应结构：

{
  "code": 0,           // 0=成功，非0=错误
  "message": "success",
  "request_id": "...",  // 请求追踪 ID
  "data": { ... }       // 业务数据，各接口不同
}

上传正面照 → 返回标注好的 PNG（仅标注图层，透明底）+ 四庭七眼厘米数值 + 关键点像素坐标。

入参

data 字段

💡 前端把标注图叠加到原图上即可呈现测量效果（标注图白色线条 #FFFFFF，透明底）。

请求示例（fetch）：

const fd = new FormData();
fd.append('image_file', file);  // 或 image_url / image_base64

const res = await fetch('https://hair.xiangsilian.com/api/v1/face/measure', {
  method: 'POST',
  body: fd
});
const { code, data } = await res.json();
// data.annotated_image_url  →  标注 PNG
// data.face_total_height_cm  →  全脸高度
// data.four_courts.ratios    →  { top_court: 0.25, ... }
// 前端叠加显示：原图 + annotated_image_url（absolute 叠加）

上传正面照 + 性别 + 发型序号 → 返回指定发际线类型的发际线曲线透明 PNG + 生发图。

入参

data.results[] 元素

💡 image_url 是透明底 PNG，前端需用绝对定位叠加到原图上显示（参考 测试页 的 .img-stack 叠加结构）。

Female 5 种：ellipse/flower/heart/straight/wave  |  Male 4 种：ellipse/m/straight/inverse_arc
⚠ 生发图由本机 ComfyUI 生成，耗时可达数分钟，fetch 超时需放大（≥5min）。

医生用马克笔在用户照片额头画线 → 拍照上传 → 系统生成生发效果图。

入参

data 字段

⚠ 划线图未检测到划线（或无人脸）→ code=1001

上传照片 → 火山方舟豆包视觉模型分析 → 返回固定 6 项面部特征（脸型/眉形/面部年龄/动静类型/性别/基因风格）。

入参：image_file / image_url / image_base64 三选一。无其他参数。

data 字段

features 字段（固定返回 6 个）：

const res = await fetch('https://hair.xiangsilian.com/api/v1/face/features', {
  method: 'POST',
  body: fd
});
const { code, data } = await res.json();
const features = JSON.parse(data.features);  // ← 注意：data.features 是字符串！
console.log(features.face_shape);   // "鹅蛋脸"
console.log(features.gene_style);   // "自然型"

上传正面照 + 性别 + 多选发型 → 每个选中发型 middle/high/low 三档发际线叠图 + 生发图 + 最佳发际线中心点坐标。

入参（同接口2：先选性别，再多选发型）

data 字段

face_measure 字段（与接口1 的 data 同构，不含 annotated_image_*）：

💡 前端无需额外请求接口1 即可拿到四庭七眼测量数值；face_measure 为 null 时（角度过大/无人脸等）仅隐藏测量区块，发际线结果照常展示。

基于接口1的变体。上传正面照 → 返回标注 PNG + 三庭七眼数据。与接口1 的差异：

• 去顶庭：不画头顶横线、不返回顶庭数据，face_total_height_cm = 上+中+下庭
• 竖线范围：发际线→下巴尖（接口1 为头顶→下巴尖）
• 无头部端线：仅七眼 6 点 5 段标尺（接口1 为 8 点 7 段）

入参

data 字段

注：1004 仍在使用（接口2/5 的 gender 校验）；接口7（grow-v2）已弃用，请改用接口2。

完整 API 文档：/docs（Swagger UI）