# 旷视具体需求

## 五个接口

---

## 1. 四庭七眼测量接口

**输入**：照片

**输出**：标注好数据的 PNG 图片（**不要人物**），以及四庭七眼坐标或图片，要显示厘米数（需要设计稿）。

### 接口返回数据要求

#### 四庭比例数值

- `<顶庭：XXcm>`，约占 `<全脸高度的 22%>`
- `<上庭：长约XXcm>`，约占 `<全脸高度的 25%>`
- `<中庭：长约XXcm>`，约占 `<全脸高度的 28%>`
- `<下庭：长约XXcm>`，约占 `<全脸高度的 25%>`
- `<全脸长约xxcm>`

#### 七眼比例数据

- `<眼宽度约xxcm>`
- `<脸宽xxcm>`
- `<两眼间距约xxcm>`

### UI 图片要求

| 项目 | 要求 |
|------|------|
| 字体及线颜色色值 | `#FFFFFF` 100% |
| 数值排布 | 四庭数值统一在图片**左侧**呈现；七眼间距**上下穿插**展示 |
| 字体 | PingFangSC-Regular，字号 10pt |
| 线宽 | 横线、竖线、虚线均为 1pt |
| 线样式 | 横线、竖线渐变消失；虚线两侧呈现箭头 |

### 参考图：分析图片规范 · 版本 2

![分析图片规范版本2](旷视具体需求_media/image4.jpeg)

图中标注说明：

| 标注 | 含义 |
|------|------|
| 头顶 | 头顶位置 |
| 发际线 | 发际线位置 |
| 眉心 | 眉心位置 |
| 鼻翼下缘 | 鼻翼下缘位置 |
| 下巴尖 | 下巴尖位置 |
| 顶庭 / 上庭 / 中庭 / 下庭 | 四庭分段（示例各约 3.44cm） |

### 设计稿参考（魔镜 2）

![魔镜2设计稿](旷视具体需求_media/image6.png)

> 虚线：两侧箭头呈现。

---

## 2. C 端生发接口

**输入**：图片（用户拍摄的正面照）

**输出**：生发后图片 + 发际线图片（可能多张）

### 图片要求

- 上传是否有大小要求？图片最大、最小的要求是多少？
- **最低分辨率**：1080 × 1920
- **最大分辨率**：4000 × 5000

### 识别与错误

返回图片是否可以识别？如果图片识别失败，会返回具体错误原因吗？

- 【无法识别人像】【人像分辨率过低】
- 【角度问题，非正面照】
- 【男女】标签判断

### 其他

- 生发图是否可以带美颜效果？

### 需要返回的图片内容

示例 1（排序 1）：

- `<生成后图片url>`
- `<图片对应的发际线形>`【花瓣形】
- `<排序>`【1】

示例 2（排序 2）：

- `<生成后图片url>`
- `<图片对应的发际线形>`【波浪形】
- `<排序>`【2】

---

## 3. B 端生发接口

**输入**：划线图片（医生/操作端在原图上标注目标发际线）

**输出**：最合适发际线图片 + 生发后图片

---

## 4. 用户特征接口

**输入**：图片

**输出**：N 个用户特征字段

### 优先返回

| 字段 | 说明 |
|------|------|
| `<脸形>` | 脸形 |
| `<眉形>` | 眉形 |
| `<面部年龄>` | 面部年龄 |
| `<动静类型>` | 动静类型 |
| `<性别>` | 性别 |
| `<面部特征>` 对应面部标签的 `<基因风格>` | 基因风格 |

**剩余标签 & 数据**：后续返回即可。

![用户特征参考](旷视具体需求_media/image9.png)

---

## 5. 发际线 PNG 生成接口

**输入**：用户照片

**输出**：

- N 张用户发际线的 PNG 图片
- 最合适发际线面部中间点的坐标

---

## 文档附图

以下为原 Word 文档中的其他嵌入图片（水印/版式参考）：

| 图片 | 说明 |
|------|------|
| ![image2](旷视具体需求_media/image2.png) | 文档附图 |
| ![image3](旷视具体需求_media/image3.png) | 文档附图 |
| ![image5](旷视具体需求_media/image5.png) | 文档附图 |

---

> 本文档由 `旷视具体需求.docx` 自动转换生成。图片保存在 `旷视具体需求_media/` 目录。