API 文档 · 简洁版
快速接入速查(详细契约见 API 接口文档)
① 统一链接
引擎推理入口:POST /infer(内部 http://127.0.0.1:8200)。模型:tibetan / tcm / comprehensive / dual / cross_verify / dynamic。
② 鉴权
携带有效 token(via='token',Token 内 role/user_id 优先);无 Token 则按请求内 role/user_id 判定(缺省 guest)。vip 才有 dynamic(动态建模)、report;admin 全部。
③ 一次调用(dynamic 示例)
curl -s http://127.0.0.1:8200/infer \
-H 'Content-Type: application/json' \
-d '{"model":"dynamic","answers":{"Wood":2,"Fire":0,"Earth":1,"Metal":2,"Water":1,"L":2,"T":0,"B":1},"engine_mode":"platform","role":"vip"}'
→ code=0,health_index=0.4988(严重失衡),返回 factors(E=1+δ)与 imbalances 失衡点。
④ 常见错误速查
| 码 | 含义 |
|---|---|
401 | Token 无效/缺失 |
403 | 权限不足(角色不支持该模型) |
429 | 配额用尽 |
4001/400 | 请求体非法 |
5001 | 推理无结果 |
4040/404 | 未知端点 |