配置与鉴权

环境变量

HKGAI_BASE_URL=https://test-new-api.hkchat.app
HKGAI_API_KEY=你的真实令牌
HKGAI_MODELS_METHOD=GET
HKGAI_REQUEST_TIMEOUT_MS=60000
HKGAI_MODEL_CACHE_TTL_MS=60000

只需要配置网关和 Key，不需要维护模型清单。模型、翻译、ASR、TTS 和视频 LLM 使用的具体 ID 从 /api/models 返回结果中选择。

请求约定

上游请求统一使用：

Authorization: Bearer ${HKGAI_API_KEY}

前端只访问本项目的 /api/*，由服务端代理上游请求，避免 Key 进入浏览器。

配置检查

curl -sS http://127.0.0.1:9001/api/config
curl -sS http://127.0.0.1:9001/api/health

返回中只显示 hasApiKey 等脱敏状态，不会显示 Key 明文。

密钥规则

.env 不提交 Git，不复制到截图、日志或工单。
不在前端代码、示例文件和 README 中写入真实 Key。
Key 失效时只替换本机 .env，不要修改模型代码。