⚡ 通用配置與一鍵匯入
掌握三類客戶端連線接入方式：聊天預設一鍵匯入、API 金鑰快捷呼起與通用引數手動配置。
平臺支援將 API 金鑰與端點快速匯入或配置到多種主流 AI 聊天客戶端，方便測試和日常高頻使用。
客戶端整合方式
整合第三方 AI 客戶端通常有三種方式：
- 聊天預設一鍵匯入
- API 金鑰一鍵呼起匯入
- 手動複製配置引數
使用前準備
- 登入控制台，進入「API 金鑰」管理頁，建立一個專屬金鑰。
- 確認金鑰處於啟用狀態且額度充足，且未受模型白名單或 IP 限制影響。
建立和管理 API 金鑰的具體說明請參閱 API 金鑰 頁面。
方式一：聊天預設一鍵匯入
- 點選左側欄「聊天」展開已預置的主流聊天應用列表。
- 點選目標聊天客戶端（如 Cherry Studio、NextChat、AQBot 等）。
- 瀏覽器將提示喚起本地已安裝的對應客戶端軟體。
- 系統將自動向客戶端注入 Base URL 與憑證引數，完成即開即用。
方式二：API 金鑰一鍵呼起匯入
- 進入左側欄「API 金鑰」頁面。
- 在目標金鑰右側操作選單點選「...」 → 「聊天」 → 選擇目標應用。
- 瀏覽器將攜帶當前金鑰直接喚起本地客戶端，免去手動複製貼上的繁瑣步驟。
方式三：手動配置通用應用
對於未內建一鍵協議的應用，可以通過通用手動配置接入：
| 配置項 | 填寫說明 | 獲取來源 |
|---|---|---|
| API Base URL | 填入 https://api.openrely.ai/v1 | 平臺首頁或控制台概覽 |
| API Key | 填入平臺頒發的 sk- 格式金鑰 | API 金鑰 |
| 模型名稱 | 填入標準 Model ID（如 gpt, claude 等） | 模型廣場 |
通用配置步驟
- 開啟第三方 AI 客戶端的「設定」或「模型提供商（Providers）」。
- 選擇「OpenAI」或「自定義 OpenAI 相容介面」。
- 填入上述 Base URL 與 API Key。
- 點選拉取模型列表或儲存配置，即可開啟對話。
目前官方驗證相容的熱門 AI Coding 與對話應用（如 Claude Code、Cursor、Cline、NextChat、Cherry Studio、AQBot 等）的專屬配置圖文教程，請查閱 AI 應用接入專區。
常見問題與排障
- 點選沒有啟動桌面客戶端：請確保本地已預先安裝並至少執行過一次該桌面客戶端，以使作業系統成功註冊對應 URL Scheme 協議。
- 提示沒有可用金鑰：請先在「API 金鑰」頁建立金鑰，並確認餘額或訂閱未欠費。
- 請求返回 401 Unauthorized：檢查客戶端中填寫的 API Key 是否包含多餘空格，或金鑰是否已被停用/刪除。
- 請求返回 404 Model Not Found：確認請求的模型名稱與平臺模型廣場中支援的 Model ID 一致，並確認金鑰未設定限制排除了該模型。
這篇文件對您有幫助嗎？