# 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-TW/docs/quickstart)執行唯讀 GET /v1/models，確認驗證與目錄。再分別驗收短文字非串流、串流及所需的完整工具呼叫往返。生成測試可能扣款，請保存請求編號並核對[消費分析](/zh-TW/docs/billing)。失敗時在[工單](/zh-TW/support)提供版本、模型 ID、端點、狀態碼及已遮蔽敏感資訊的錯誤；請勿盲目重送逾時任務。

可將本 MD 交給開發者或 Agent，要求保留原設定、僅替換可用模型並明確回報未驗證項。真實金鑰請勿寫入共享 MD。

## 官方參考

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