xsl/hair
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: 将52号接口范围限定为GPU worker

Browse Source 
撤回52号网关路由、图片字段改名和mock改动，gateway目录恢复a3fddbb。worker保持base64和null响应，更新接口说明和回归测试。

验证：worker API、IP限制与网关兼容性共54项测试通过。
This commit is contained in:
xsl
2026-11-04 10:45:16 +08:00
parent 5b2b73f5d5
commit 1c51f3eaab
11 changed files with 58 additions and 92 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/接口文档.md
+19 -19
View File
@@ -526,7 +526,7 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
**说明**：入参同接口2（先选性别、再多选发型）。对每个选中发型返回一张 `middle` 设计叠图与生发图。**目标上庭 =（中庭 + 下庭）÷2**，从眉心向上定位；所有形状的中点对齐同一目标。`high` / `low` 已停用，旧字段保留为 `null`。
**请求**：`POST /api/v1/hairline/generate-52`
**请求**：`POST /api/v1/hairline/generate-52`（仅GPU worker，端口8187；本次不在网关新增路由）
**IP限制**：GPU worker的所有动态接口统一仅允许本机回环地址、本机网卡地址及白名单；目前白名单含网关IP `49.232.51.171`，其他直连来源需加入`ip_access.json`的`allowed_ips`。该文件支持单个IP与CIDR，修改后立即生效；拒绝时返回HTTP403、code=1010。网关不启用此限制，已有鉴权仍保留。详见[接口IP白名单](接口IP白名单.md)。
@@ -555,7 +555,7 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
### 高度规则与对比
- **参数与字段**：原有8个请求参数、响应外层结构和所有旧返回字段均保留。`use_mask=true`、默认prompt、`generate_grow_image=true`保持原值。新功能只新增可选参数和返回字段；旧请求未传`normalize_image`时保留原图坐标，high/low按已约定保留null，worker仍返回`*_base64`，网关仍返回对应`*_url`。
- **参数与字段**：原有8个请求参数、响应外层结构和所有旧返回字段均保留。`use_mask=true`、默认prompt、`generate_grow_image=true`保持原值。新功能只新增可选参数和返回字段；旧请求未传`normalize_image`时保留原图坐标，high/low按已约定保留null，worker始终返回`*_base64`，不负责保存图片、生成公网URL或改名；网关保持原样。
- `height_rule`：`middle_height_px`、`lower_height_px`、`target_upper_height_px`、`target_upper_height_cm`（可空）、`target_center`、`brow_center`、`nose_bottom`、`chin_tip`、`measurement_source`。
- 每项 `height_placement`：`old_center`、`new_center`、`shift_x_px`、`shift_y_px`（正=下移）、`target_error_px`。浮点坐标保留精度，旧中心点字段继续返回取整像素。
- `face_measure` 为处理后底图的实际测量值，未被设计目标覆盖。
@@ -573,8 +573,8 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
| best_hairline_center_point | object \| null | **首个选中发型**的 **middle 档**发际线曲线「面部中间点」坐标，当前底图像素：`{ "x": number, "y": number }` |
| high_hairline_center_point | object \| null | 已停用，固定 `null` |
| low_hairline_center_point | object \| null | 已停用，固定 `null` |
| input_image_url | string | 当前底图，发际线叠图、参考点和测量值均使用该图的坐标系 |
| original_image_url | string | EXIF方向修正后的上传原图 |
| input_image_base64 | string | 当前底图的JPEG base64，发际线叠图、参考点和测量值均使用该图的坐标系 |
| original_image_base64 | string | EXIF方向修正后的上传原图JPEG base64 |
| width / height | int | 当前底图的实际像素宽 / 高 |
| coordinate_space | string | 开启预处理时为 `processed_image`，关闭时为 `original_image` |
| framing | object \| null | 裁切状态、旋转角、前后尺寸、轴线误差及双向仿射矩阵；关闭预处理时为 `null` |
@@ -587,16 +587,16 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
| 字段 | 类型 | 说明 |
|------|------|------|
| hairline_type | string | 发际线类型 key：`ellipse`/`flower`/`heart`/`straight`/`wave`/`bigflower`/`clasicalflower`（female），`ellipse`/`m`/`straight`/`inverse_arc`/`heart`/`Softpetal`/`wave`（male） |
| image_middle_url | string | middle 档发际线曲线**透明 PNG** URL（仅曲线，透明底，**不含人物**，需叠加 `input_image_url` 显示） |
| image_high_url | null | 已停用，保留字段为 `null` |
| image_low_url | null | 已停用，保留字段为 `null` |
| grown_image_url | string \| null | **生发后图片** URL（ComfyUI「植发」效果图，完整人像照片，生发失败或 `generate_grow_image=false` 时为 `null`） |
| image_middle_base64 | string | middle 档发际线曲线**透明 PNG** base64（仅曲线，透明底，**不含人物**，需叠加 `input_image_base64` 显示） |
| image_high_base64 | null | 已停用，保留字段为 `null` |
| image_low_base64 | null | 已停用，保留字段为 `null` |
| grown_image_base64 | string \| null | **生发后图片** JPEG base64（ComfyUI「植发」效果图，完整人像照片，生发失败或 `generate_grow_image=false` 时为 `null`） |
| order | int | 发型序号（= 传入的 hair_style 值） |
| height_placement | object | 旧/新中心、XY移动距离、目标误差，均为未取整的像素值 |
> worker 侧返回 `image_middle_base64` / `image_high_base64` / `image_low_base64` / `grown_image_base64`，网关落盘后改写为上表对应的 `*_url`。
> 上表为GPU worker的实际响应字段；所有图片使用base64，空图片保留原字段并返回null。网关的落盘与URL改写属于网关职责，本次不修改。
>
> 💡 `image_middle_url` 为透明底 PNG，前端需用绝对定位叠加到 `input_image_url` 上显示（参考[测试页](https://hair.xiangsilian.com/static/test_interface52.html)的 `.img-stack` 叠加结构）。`grown_image_url` 是完整人像照片，直接显示即可。worker返回上述图片的 `*_base64`，网关改写为 `*_url`。
> 前端将base64转为data URI后显示。middle透明图叠加到`input_image_base64`，生发图直接显示。GPU worker本机测试页为`http://localhost:8187/static/test_interface52.html`。
`face_measure` 元素（与[接口1](#接口-1四庭七眼测量标注接口)的 `data` 同构，**不含** `annotated_image_*` 标注图字段）：
@@ -613,9 +613,9 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
> `eye1`~`eye7` 为从左到右共 7 段宽度，eye1=左耳外段、eye7=右耳外段，某侧耳朵不可见时对应段为 `null`。详见接口1说明。
### 网关响应结构示例（normalize_image=false）
### GPU worker响应结构示例（normalize_image=false）
此例未开启裁切，坐标基于原图；`face_measure=null`时仍可按发际线关键点计算目标。网关对接口52的所有空图片字段均返回`*_url: null`。worker直连时图片字段名对应为`*_base64`，图片内容为base64。
此例未开启裁切，坐标基于原图；`face_measure=null`时仍可按发际线关键点计算目标。图片内容以缩略base64字符串示意，空图片字段返回null，字段名不变。
```json
{
@@ -626,10 +626,10 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
"hairline_images": [
{
"hairline_type": "ellipse",
"image_middle_url": "https://hair.xiangsilian.com/static/annotations/mid1.png",
"image_high_url": null,
"image_low_url": null,
"grown_image_url": "https://hair.xiangsilian.com/static/annotations/grown1.jpg",
"image_middle_base64": "iVBORw0KGgo...",
"image_high_base64": null,
"image_low_base64": null,
"grown_image_base64": "/9j/4AAQ...",
"order": 1,
"height_placement": {
"old_center": {"x": 540.0, "y": 450.0},
@@ -641,8 +641,8 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
"best_hairline_center_point": {"x": 540, "y": 430},
"high_hairline_center_point": null,
"low_hairline_center_point": null,
"input_image_url": "https://hair.xiangsilian.com/static/annotations/input.jpg",
"original_image_url": "https://hair.xiangsilian.com/static/annotations/original.jpg",
"input_image_base64": "/9j/4AAQ...",
"original_image_base64": "/9j/4AAQ...",
"width": 1080, "height": 1440,
"coordinate_space": "original_image",
"framing": null,
@@ -666,7 +666,7 @@ GPU worker的所有动态接口均启用IP限制：允许本机及`ip_access.jso
}
```
开启`normalize_image=true`后，`coordinate_space=processed_image`，`framing`包含前述裁切状态和坐标变换，所有发际线图片须叠加到`input_image_url`。原始图片仅用于展示和坐标回溯。
开启`normalize_image=true`后，`coordinate_space=processed_image`，`framing`包含前述裁切状态和坐标变换，所有发际线图片须叠加到`input_image_base64`。原始图片仅用于展示和坐标回溯。
---