diff --git a/docs/接口文档.md b/docs/接口文档.md index cb31cd2..f1fcc00 100644 --- a/docs/接口文档.md +++ b/docs/接口文档.md @@ -261,6 +261,7 @@ | hair_style | string | **是** | 发型序号，**逗号分隔多选**（如 `1,2,3`），最多不超过该性别的预设数。female：1=ellipse, 2=flower, 3=heart, 4=straight, 5=wave；male：1=ellipse, 2=inverse_arc, 3=m, 4=straight。越界/非法返回 `1007` | | beauty_enabled | bool | 否 | 生发图是否带美颜效果，默认 false（当前阶段不生效） | | use_mask | bool | 否 | 是否启用 inpaint 遮罩，默认 `true`。`false` 时用干净原图生成（空遮罩、不烧模板黑线），供测试对比 | +| prompt | string | 否 | ComfyUI 提示词，默认「补充遮罩区域的头发，加一点美颜」，会替换工作流节点 60 的文本 | ### 输出（data） @@ -315,6 +316,7 @@ |------|------|------|------| | marked_image_* | file / string | 是 | 已用马克笔标注发际线的图片，三选一 | | use_mask | bool | 否 | 是否画发际线，默认 `true`。`false` 时跳过划线检测、直接送划线图，模型仅凭手绘黑线生发，供测试对比 | +| prompt | string | 否 | ComfyUI 提示词，默认「补充遮罩区域的头发，加一点美颜」，会替换工作流节点 60 的文本 | ### 输出（data） @@ -399,7 +401,7 @@ | gender | string | **是** | 性别：`male` / `female`。决定发型集合（female 5 / male 4）。缺失/非法返回 `1004` | | hair_style | string | **是** | 发型序号，**逗号分隔多选**（如 `1,2,3`），决定返回哪些发际线类型。female：1=ellipse, 2=flower, 3=heart, 4=straight, 5=wave；male：1=ellipse, 2=inverse_arc, 3=m, 4=straight。缺失/越界/非法返回 `1007` | | use_mask | bool | 否 | 生发是否启用 inpaint 遮罩，默认 `true`。`false` 时用干净原图生成（空遮罩、不烧模板黑线），供测试对比 | -| prompt | string | 否 | ComfyUI 提示词，默认「补充遮罩区域的头发」，会替换工作流节点 60 的文本 | +| prompt | string | 否 | ComfyUI 提示词，默认「补充遮罩区域的头发，加一点美颜」，会替换工作流节点 60 的文本 | > ⚠️ 三档叠图分别用 `hairline_texture` / `hairline_texture_high` / `hairline_texture_low` 三套同名贴图；**生发黑模板固定取自 `hairline_texture_black/`（middle 档）**，即生发目标固定压到 middle 档，每个发型仅 1 张生发图。 @@ -515,6 +517,7 @@ | hair_style | string | **是** | 发型序号，**逗号分隔多选**（如 `1,2,3`）。female：1=ellipse, 2=flower, 3=heart, 4=straight, 5=wave；male：1=ellipse, 2=inverse_arc, 3=m, 4=straight。越界/非法返回 `1007` | | beauty_enabled | bool | 否 | 生发图是否带美颜效果，默认 false（当前阶段不生效） | | use_mask | bool | 否 | 是否启用 inpaint 遮罩，默认 `true`。`false` 时用干净原图生成（空遮罩、不烧模板黑线） | +| prompt | string | 否 | ComfyUI 提示词，默认「补充遮罩区域的头发，加一点美颜」，会替换工作流节点 60 的文本 | ### 输出（data） @@ -522,8 +525,8 @@ | 字段 | 类型 | 说明 | |------|------|------| -| image_url | string | 方案**预览图** URL（发际线曲线叠加图） | -| grown_image_url | string | **生发后图片** URL（ComfyUI/Flux「植发 3 个月」效果图） | +| image_url | string | 发际线曲线**透明 PNG** URL（仅曲线，透明底，**不含人物**，需叠加原图显示） | +| grown_image_url | string | **生发后图片** URL（ComfyUI/Flux「植发 3 个月」效果图，完整人像照片） | | hairline_type | string | 发际线类型 key | | order | int | 排序序号 | diff --git a/static/integration.html b/static/integration.html index 367b00b..81e8a0a 100644 --- a/static/integration.html +++ b/static/integration.html @@ -133,7 +133,7 @@ const { code, data } = await res.json();

2. C端生发  POST  /api/v1/hair/grow

-

上传正面照 + 性别 + 发型序号 → 返回指定发际线类型的预览图与生发图。

+

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

入参

@@ -301,8 +301,8 @@ console.log(features['四季色彩季型']); // "冷夏型"（中文字段也保

data.results[] 元素（同接口2）

- - + +
字段类型说明
image_urlstring发际线叠加预览图
grown_image_urlstring生发后效果图 ⚠ 可空
image_urlstring发际线曲线透明 PNG（仅曲线，需叠加原图显示，同接口2）
grown_image_urlstring生发后效果图（完整人像）⚠ 可空
hairline_typestring发际线类型 key
orderint排序
diff --git a/static/test_interface2.html b/static/test_interface2.html index 1f10e9e..eb2b4a5 100644 --- a/static/test_interface2.html +++ b/static/test_interface2.html @@ -106,7 +106,7 @@
JPG/PNG  |  生发图生成较慢（数十秒~数分钟），请耐心等待
- +
diff --git a/static/test_interface3.html b/static/test_interface3.html index f7cdb58..e65d6f5 100644 --- a/static/test_interface3.html +++ b/static/test_interface3.html @@ -93,7 +93,7 @@
💬 提示词（prompt）
- +
diff --git a/static/test_interface7.html b/static/test_interface7.html index 16be61a..e54fa17 100644 --- a/static/test_interface7.html +++ b/static/test_interface7.html @@ -103,7 +103,7 @@
JPG/PNG  |  生发图生成较慢（数十秒~数分钟），请耐心等待  |  工作流: add_hair2.json
- +