环境准备
接入前请先确认：- 已部署并启动可用的 LibreChat 实例，推荐使用 v0.7.5 或更高版本。
- 已在 AIHubMix 控制台 创建 API Key，格式通常为
sk-***。 - 可以修改 LibreChat 部署目录中的
.env文件。.env位于 LibreChat 项目根目录，也就是与package.json、docker-compose.yml同级的位置。 - 配置文件位置通常是
你的安装路径/LibreChat/.env；如果该文件不存在，可以把同目录下的.env.example复制一份并重命名为.env。 - 修改配置后需要重启 LibreChat。
配置 .env
LibreChat 接入 AIHubMix 的核心就是修改安装目录里的 .env：把 OpenAI 端点指向 AIHubMix 网关，并配置 API Key。
需要修改的文件位置是：
.env 文件，找到 OpenAI 相关配置区；如果找不到，也可以直接把下面几行追加到 .env 文件末尾。
.env，可以把 OPENAI_API_KEY 改成 LibreChat 的用户自填模式：
user_provided 是 LibreChat 的特殊写法，表示不把 Key 写死在服务器配置里，而是在用户界面中由当前登录用户自己填写。两种写法只影响 Key 的保存位置，模型仍然都会出现在 LibreChat 的 OpenAI 端点下。
如遇当前 API 主地址不可用，可把 OPENAI_REVERSE_PROXY 改为备用地址：
OPENAI_MODELS。如果你只想固定展示部分模型，可以在 .env 中补充 OPENAI_MODELS，多个模型用英文逗号分隔：
OPENAI_MODELS，或保留 .env 中 # OPENAI_MODELS=... 的注释状态。保存后重启 LibreChat，在模型/端点选择区域选择 OpenAI，再选择要使用的模型即可。
重启 LibreChat
修改.env 后必须重启服务，否则新配置不会生效：
- 使用本地脚本启动：重新运行你的 LibreChat 启动脚本。
- 使用源码或 npm 启动：进入 LibreChat 项目根目录，也就是
.env所在目录，重新执行你原本的启动命令。 - 使用 Docker 部署：在
docker-compose.yml所在目录执行docker compose restart，或重新启动对应容器。
效果说明
配置完成后，模型都会出现在 LibreChat 的 OpenAI 端点下，模型列表由 AIHubMix 返回，涵盖 AIHubMix 当前支持的模型。只有在.env 中手动启用了 OPENAI_MODELS 时，页面才会只显示你写入的那部分模型。
参考资源
- AIHubMix 官网：aihubmix.com
- LibreChat 官网：librechat.ai
- LibreChat 本地安装文档：librechat.ai/zh/docs/local/npm
- LibreChat 环境变量示例：github.com/danny-avila/LibreChat/blob/main/.env.example