● 运行中 · 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 KEY | POST /llm-hub/api/me/key |
| 吊销 API KEY | POST /llm-hub/api/accounts/key/revoke |
| 健康探针 | GET /llm-hub/healthz |
同一个账号,两种用模型的方式;配额、计量、审计是同一套(换方式不用换账号,用量合并计算)。
| 方式 | 适合谁 | 凭据 |
|---|---|---|
| A · 账号登录 已有 |
鸿蒙AI编程实训系统等内置登录的产品:学生输账号+口令,系统拿到会话凭据直接调模型 | 账号 + 口令 ⇒ 会话凭据 hb-s-…(12 小时过期,重新登录即可) |
| B · API KEY 本次新增 |
DSH / ZCode / IDE / curl / 任何 OpenAI 兼容客户端:只认 api_key,不需要登录界面 |
静态 KEY hb-…(不过期;可设有效期、可轮换、可随时吊销) |
两步:先有账号,再用账号自助领 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 立即失效;同一个接口,重复调用即轮换)
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"共用配额——不管用哪种方式接入,用量都记在同一个账号上。