-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ zh TW
語言： EN · 中文 · 日本語 · Deutsch · Tiếng Việt · 繁體中文 · 首頁
面向 AIGateway 使用者的高頻問答。更多排錯見 故障排除；上手見 快速開始。
本機 AI 模型管理 + 流量閘道。把多家大模型 API 與常見 AI 工具（ChatGPT/Codex、Claude Code、OpenClaw、Harness 等）接在一起：
- 省 Token：按廠商 / 模型看用量
- 換便宜服務商：多廠商一處管理，隨時切換
- 一次設定，多工具共用：工具只指向本機閘道
- 熱路由與容災：虛擬模型組 + 優先順序 Failover（如 429 / 額度耗盡）
V2 採用 一次接管、終身調度：工具的 base_url 只改一次指向閘道；之後換模型 / 換廠商在閘道內完成。
AIGateway 在本機執行。請求依你設定的廠商轉發到對應上游 API；設定與用量預設保存在 ~/.codex-manager/。請自行保護 API Key。
macOS（Apple Silicon / Intel）、Windows、Linux。安裝包見 Releases。
一般使用者使用發行版桌面應用即可。從原始碼建置才需要 Go、前端建置環境等。
http://127.0.0.1:18080/v1
建議在 應用管理 使用 一鍵接管。手動設定時：
- Base URL：
http://127.0.0.1:18080/v1 - API Key：可用佔位值
aigateway -
model：填 模型組名稱
是。退出後本機代理不可用。
廠商管理 → 選 預設 → 貼上 API Key → 拉取 / 啟用模型。多數雲廠商只需 Key。
| 模式 | 含義 |
|---|---|
| 標準 OpenAI | 閘道規整請求/回應 |
| 原樣轉發 | 盡量透傳 body |
不確定時優先試標準 OpenAI。
把不同廠商上的同名/等價模型聚合成一組。用戶端只寫一個模型名，閘道按優先順序選通道。
429 限流、額度/配額、帳戶異常（如 401）等。全部失敗則 model_group_all_exhausted。
有限制：首包 / HTTP 錯誤可切換；已開始向用戶端推流後無法無感中途換通道。見 故障排除。
ChatGPT（Codex）、Claude Code、OpenClaw、Harness。
定位工具設定檔 → 備份 → 將 base_url（及必要 provider 欄位）指向本機閘道。
卡片內 一鍵解除 / 還原，或 ~/.codex-manager/backups/。
Codex 保留 ID / aigateway_api_key：見 故障排除。
Token 統計 頁；SQLite aigateway.db。路徑見 資料與路徑。API Key 不會上傳到 GitHub。
彈窗：簡體中文、繁體中文、English、日本語、한국어、Deutsch、Tiếng Việt、ไทย。
五個主功能區：廠商管理 / 模型管理 / 應用管理 / 統一入口 / Token 統計。
v1 → v2：首次啟動 JSON → SQLite 遷移。請重新確認統一入口與接管狀態。
Issue：https://github.com/vincent1986/AIGateway/issues/new/choose
授權：MIT © Mars Waller
| 項目 | 值 |
|---|---|
| 預設 Base URL | http://127.0.0.1:18080/v1 |
| 本機 API Key 佔位 | aigateway |
| 資料目錄 | ~/.codex-manager/ |
| 全通道耗盡錯誤碼 | model_group_all_exhausted |
AIGateway · MIT License · Issues · Wiki Home · EN · 中文 · 日本語 · DE · VI · 繁中
AIGateway Wiki
Language / 语言
English
中文（简体）
日本語
Deutsch
Tiếng Việt
繁體中文
Links