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 失衡点。

④ 常见错误速查

码含义
401Token 无效/缺失
403权限不足(角色不支持该模型)
429配额用尽
4001/400请求体非法
5001推理无结果
4040/404未知端点