# LobeChat / LobeHub 接入指南

## 适用范围与前提

本页提供 LobeChat / LobeHub 对接本站的配置说明。需要启用的本站密钥、可用余额以及协议匹配的实际可用模型。2026-10-24 已核对官方资料；这不代表每个客户端版本及上游模型都已完成全流程测试。

## 配置步骤

1. 本页面向允许自定义供应商的自托管部署，不代表公共云版本一定开放相同入口。
2. 由部署管理员在私密环境配置中设置 OPENAI_PROXY_URL、OPENAI_API_KEY，并按所用版本添加模型列表。
3. OPENAI_PROXY_URL 使用本站 /v1 基址，模型列表只填写已确认可用的准确 ID。
4. 按部署流程应用配置后，在供应商设置或模型选择器核对生效结果，再测试简短聊天。

## 配置值对照

| 配置项 | 填写内容 |
| --- | --- |
| OPENAI_PROXY_URL | https://u9ai.ai/v1 |
| API Key | YOUR_U9AI_API_KEY · 本站 API 密钥 |
| Model | YOUR_CHAT_MODEL_ID · 实际可用模型 ID |
| 最终文本请求端点 | https://u9ai.ai/v1/chat/completions |

```dotenv
OPENAI_PROXY_URL=https://u9ai.ai/v1
OPENAI_API_KEY=YOUR_U9AI_API_KEY
OPENAI_MODEL_LIST=YOUR_CHAT_MODEL_ID
```

## 这个工具需要特别注意

示例变量来自官方仓库，具体部署版本可能调整名称或改由管理页面配置；以匹配版本为准。密钥仅保存在私密环境或密钥管理系统，不上传公开仓库；共享部署的用量会计入所填密钥所属账户。

## 验收与交接

先按[快速开始](/zh-CN/docs/quickstart)执行只读 GET /v1/models，确认认证和目录。再分别验收短文本非流式请求、流式输出及所需的完整工具调用往返。生成测试可能扣费，请保留请求号并核对[消费分析](/zh-CN/docs/billing)。失败时在[工单](/zh-CN/support)提供客户端版本、模型 ID、端点、状态码和脱敏错误；超时任务不要盲目重提。

可将本 MD 直接交给开发者或 Agent 阅读，要求保留原配置、只替换实际可用模型，并明确报告未验证项。真实密钥不要写入共享 MD。

## 官方参考

[LobeChat / LobeHub](https://github.com/lobehub/lobehub/blob/canary/.env.example)