diff --git a/static/integration.html b/static/integration.html index 52c346d..e83a35e 100644 --- a/static/integration.html +++ b/static/integration.html @@ -72,6 +72,7 @@ Content-Typemultipart/form-data 图片参数三选一：image_file（文件上传）/ image_url（URL）/ image_base64（base64 + 前缀） 图片格式JPG / PNG，单人正面照 + 请求体上限2MB（nginx 层限制）。超限直接返回 HTTP 413，不会进入业务逻辑。建议图片文件 ≤1MB；image_base64 传图会膨胀约 33%，编码前原图建议 ≤1.4MB。手机直拍照片通常 3~8MB，上传前务必先压缩（如最长边缩到 1500px、JPEG 质量 80）。image_url 方式图片在远端，不受此限制

统一响应结构：

@@ -190,22 +191,23 @@ const { code, data } = await res.json();

4. 用户特征分析  POST  /api/v1/face/features

-

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

+

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

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

data 字段

- +
字段类型说明
featuresstringJSON 字符串（不是对象！客户端需 JSON.parse()）。解析后得到固定 6 个英文字段
featuresstringJSON 字符串（不是对象！客户端需 JSON.parse()）。解析后得到固定 7 个英文字段
-

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

+

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

+
字段说明字段说明
face_shape脸型eyebrow_shape眉形
facial_age面部年龄区间gender性别
dynamic_static_type动静类型gene_style基因风格
contour_type轮廓类型（轮廓偏曲/轮廓适中/轮廓偏直）——
const res = await fetch('https://hair.xiangsilian.com/api/v1/face/features', {
@@ -309,6 +311,7 @@ console.log(features.gene_style);   // "自然型"
1009未授权缺少或错误的 X-Internal-Token（/api/* 路径鉴权）

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

+

⚠ HTTP 层错误不是业务 JSON：业务错误（code≠0）一律返回 HTTP 200；但请求体超 2MB 时 nginx 直接返回 413（HTML 错误页）、网关不可用时返回 502/504。客户端务必先判断 HTTP 状态码，非 200 时不要 res.json()，否则会报 Unexpected token '<'（把 HTML 当 JSON 解析）。

@@ -321,9 +324,12 @@ console.log(features.gene_style); // "自然型" 1. 四庭七眼/static/test_interface1.html上传照片 → 原图+标注叠加，底图/标注开关，指标卡片 2. C端生发/static/test_interface2.html上传+性别 → 方案一覧（原图/叠加/生发），双图对比 3. B端生发/static/test_interface3.html划线图上传 → 生发效果图 - 4. 用户特征/static/test_interface4.html上传照片 → 6项面部特征 + 原始JSON + 4. 用户特征/static/test_interface4.html上传照片 → 7项面部特征 + 原始JSON 5. 发际线PNG/static/test_interface5.html上传+性别 → 发际线方案+中心点坐标 6. 四庭七眼 v2/static/test_interface6.html同接口1，去顶庭 · 竖线发际线→下巴 · 无头部端线 + 9. 头发遮罩/static/test_interface9.html上传照片 → 头发遮罩 + 分步可视化 + 10. 外缘膨胀带/static/test_interface10.html上传照片 → 头部外缘带状遮罩 + 分步可视化 + 99. 人脸特殊点/static/test_interface99.html上传照片 → 60 关键点 + 5 发际线点坐标（测试大图请先压缩到 2MB 内，见通用约定）

完整 API 文档：/docs（Swagger UI） diff --git a/static/test_face_shape.html b/static/test_face_shape.html index 9954556..743fc51 100644 --- a/static/test_face_shape.html +++ b/static/test_face_shape.html @@ -130,7 +130,6 @@