HKGAI 内部使用指南
适用范围
本项目面向需要调用 HKGAI / NewAPI 的内部人员，提供统一配置、模型查询、文本对话、翻译、音频转写、语音合成和视频 LLM 异步任务入口。
五步上手
- 获取有权限的 HKGAI NewAPI Key。
- 在项目根目录创建
.env，只填写网关地址和 Key。 - 执行
npm install && npm run dev。 - 打开
http://127.0.0.1:9001，刷新模型目录。 - 从实时模型列表选择模型后，进入对应工作区测试。
如果怀疑某些模型“看得到但用不了”，先点击模型列表上方的“测试当前”或“测试全部”。测试结果会回写到模型表，并影响 Chat、翻译、转写和 TTS 的模型选择器。视频 LLM 不参加批量探测，请在模型详情中手动发起异步测试。
模型 ID 不写入 .env，由 /api/models 动态查询；不同账号看到的模型权限可能不同。
服务器访问
项目已部署到 115.190.241.26，内部访问地址为 https://docs-hkgai.mooschh.com，由 PM2 管理 hkgai-models 进程。服务器更新、重启、日志和 Nginx 操作见部署与运维。
能力选择
| 需求 | 工作区 | 默认验证方向 |
|---|---|---|
| 普通对话、粤语文案 | Chat | t2_qwen3-8-27b_fp8_262k |
| 普通话/粤语互译 | 翻译 | 使用可用的 OpenAI 兼容 Chat 模型 |
| 音频转文字 | 转写 | speech-recognize 或 transcription |
| 文字转音频 | TTS | tts-v1，male / female |
| 视频生成/视频理解 | 视频 LLM | t2_minimax-h3_bf16_7k2p 等模型，详情页手动测试 |
结果使用规则
粤语翻译和转写结果都要人工抽查；转写文本不直接作为正式字幕、训练文本或业务指令。TTS 当前为通用音色，不等同于声音克隆。
视频 LLM 使用 /v1/videos 异步接口，创建任务成功只代表任务已进入队列；在模型详情中刷新任务状态，完成后可下载结果。视频任务可能消耗配额，因此不在“测试全部”中自动执行。