模型汇聚路由网关

● 运行中 · OpenAI 兼容接口

本服务把多个模型上游汇聚成一个统一入口:调用方用一个 KEY 即可,系统按各上游健康状态自动选路;某个上游欠费、限流或超时时会自动切换到下一家。

可用端点

用途地址
对话(OpenAI 兼容)POST /llm-hub/v1/chat/completions
模型清单GET /llm-hub/v1/models
提交申请POST /llm-hub/api/accounts/apply
账号登录POST /llm-hub/api/login
领取 / 更换 API KEYPOST /llm-hub/api/me/key
吊销 API KEYPOST /llm-hub/api/accounts/key/revoke
健康探针GET /llm-hub/healthz

两种接入方式 2026-11-16 起

同一个账号,两种用模型的方式;配额、计量、审计是同一套(换方式不用换账号,用量合并计算)。

方式适合谁凭据
A · 账号登录
已有
鸿蒙AI编程实训系统等内置登录的产品:学生输账号+口令,系统拿到会话凭据直接调模型 账号 + 口令 ⇒ 会话凭据 hb-s-…(12 小时过期,重新登录即可)
B · API KEY
本次新增
DSH / ZCode / IDE / curl / 任何 OpenAI 兼容客户端:只认 api_key,不需要登录界面 静态 KEY hb-…(不过期;可设有效期、可轮换、可随时吊销)

怎么拿到 KEY(方式 B)

两步:先有账号,再用账号自助领 KEY。KEY 明文只在领取的那一刻显示一次(之后系统只存哈希),请立刻保存;丢了就再领一把(旧 KEY 会同时失效)。

# ① 没有账号:先提交申请(姓名+登录名+班级),等管理员/老师审核
curl -X POST http://118.89.88.174/llm-hub/api/accounts/apply \
  -H "content-type: application/json" \
  -d '{"username":"20240138","applicant":"张三","org":"示范职业技术学院"}'

# ② 审核通过后拿到「账号 + 初始口令」,登录并改口令
curl -X POST http://118.89.88.174/llm-hub/api/login \
  -H "content-type: application/json" \
  -d '{"username":"20240138","password":"初始口令"}'
# → {"sessionToken":"hb-s-…", ...};首次登录按提示改口令:
curl -X POST http://118.89.88.174/llm-hub/api/password \
  -H "authorization: Bearer hb-s-…" -H "content-type: application/json" \
  -d '{"oldPassword":"初始口令","newPassword":"你的新口令"}'

# ③ 用自己的会话领 API KEY(明文只显示这一次)
curl -X POST http://118.89.88.174/llm-hub/api/me/key \
  -H "authorization: Bearer hb-s-…" -H "content-type: application/json" -d '{}'
# → {"key":"hb-xxxxxxxx…","keyPrefix":"hb-xxxx","notice":"…只显示这一次…"}

拿到 KEY 后这样接:

base_url = http://118.89.88.174/llm-hub/v1
api_key  = hb-xxxxxxxx…(你的 KEY)
model    = auto

换 KEY / 吊销 / 有效期

# 换一把(旧 KEY 立即失效;同一个接口,重复调用即轮换)
curl -X POST http://118.89.88.174/llm-hub/api/me/key \
  -H "authorization: Bearer hb-旧KEY" -H "content-type: application/json" \
  -d '{"expiresInDays":120}'

# 吊销(KEY 立刻失效,账号和口令登录不受影响)
curl -X POST http://118.89.88.174/llm-hub/api/accounts/key/revoke \
  -H "authorization: Bearer hb-你的KEY" -H "content-type: application/json" -d '{}'

老师/管理员也可以代发或代吊销:POST /llm-hub/api/accounts/key 与 …/key/revoke,body 给 {"username":"学号"} 或 {"accountId":"acct-…"}。老师只能操作本班学生。

其他

账号管理、用量查询、路由详情等管理面需管理员凭据,不对公网开放。用量按账号记账,默认不限额;管理员可按需设配额(超限会返回 429 并给出人话提示)。同一账号的"账号登录"与"API KEY"共用配额——不管用哪种方式接入,用量都记在同一个账号上。