# 模型推理接口文档（第三方调用）

面向业务方 / 第三方的 **HTTP API** 说明。当前环境通过 HTTPS 域名接入（Caddy 反代到本机 K8s NodePort）。

| 服务 | 用途 | 基址 |
|------|------|------|
| [HumanParser](./human-parser.md) | 人体语义解析（18 类部位 mask） | `https://human-parser.model.wgdl.tech` |
| [SegmentPerson](./segment-person.md) | 人像抠图 / 主体抠图 | `https://segment-person.model.wgdl.tech` |
| [ClothYolo](./cloth-yolo.md) | 人体/服装检测、姿态、RT-DETR | `https://cloth-yolo.model.wgdl.tech` |

文档站点：`https://docs.model.wgdl.tech/`

## 通用约定

- **协议**：HTTPS（证书由接入层自动申请）
- **超时**：建议客户端超时 ≥ 60s（大图 / 冷启动首次可能更慢）
- **限流 / 鉴权**：当前文档描述的是服务原生接口；若对第三方开放，建议在网关层加 Token / IP 白名单（后续再定）
- **健康检查**：各服务均提供 `GET /health`

## 目录

```text
model_docs/
├── README.md              # 本索引
├── human-parser.md        # HumanParser 接口
├── segment-person.md      # SegmentPerson 接口（人像 + 主体）
└── cloth-yolo.md          # ClothYolo 接口
```

## 本地仓库

本目录为独立 Git 仓库，便于后续单独发布文档站点或同步到内部文档平台。