-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ zh CN
语言： 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。
官方渠道：https://github.com/vincent1986/AIGateway/releases
普通用户使用发布版桌面应用即可，无需自行搭运行时。从源码构建才需要 Go、前端构建环境等。
http://127.0.0.1:18080/v1
在 统一入口 查看运行状态与监听配置。
推荐在 应用管理 使用 一键接管。手动配置时：
- Base URL：
http://127.0.0.1:18080/v1 - API Key：可用占位值
aigateway（本地网关识别，无需真实云 Key） -
model：填 模型组名称（与模型管理中一致）
是。工具请求先到本机网关再转发上游；退出 AIGateway 后本地代理不可用。
厂家管理 → 选 预设（DeepSeek、硅基流动、Ollama、OpenAI、通义等）→ 粘贴 API Key → 拉取 / 启用模型。多数云厂家只需 Key。
| 模式 | 含义 | 适用 |
|---|---|---|
| 标准 OpenAI | 网关规整请求/响应，抹平部分非标差异 | 兼容 OpenAI 协议的云 API、需统一格式时 |
| 原样转发 Passthrough | 尽量透传 body，少做协议改写 | 特殊协议或调试上游原样行为时 |
不确定时优先试 标准 OpenAI；异常再改 Passthrough 对比。
控制该厂家下模型是否参与调度。停用后不会作为 Failover 候选。
把 不同厂家上的同名/等价模型 聚合成一组。客户端只写一个模型名，网关按优先级选通道。
上游返回如 429 限流、额度/配额类错误、账户异常（如 401） 等时，网关会按队列尝试下一顺位厂家。全部失败则返回 model_group_all_exhausted。
有限制：首包 / HTTP 层错误可切换；已经开始向客户端推流后无法无感中途换通道。详见 故障排除。
在 模型管理 中拖拽组内厂家顺序：越靠上优先级越高。
ChatGPT（Codex）、Claude Code、OpenClaw、Harness。其它 OpenAI 兼容客户端可手动填网关 Base URL。
定位工具配置文件 → 备份 → 将 base_url（及必要 provider 字段）指向本地网关。
在对应应用卡片使用 一键卸载 / 恢复（或从 ~/.codex-manager/backups/ 取备份）。
应通过 models.providers.aigateway 等方式接入；仅改根级错误字段可能导致未真正走 AIGateway。
见 故障排除：
- 保留 ID：
openai/ollama改为openai-custom/ollama-local - Key：使用
api_key = "aigateway"
应用内 Token 统计 页；底层写入 SQLite（aigateway.db）。路径见 数据与路径。
不会。Key 仅保存在本机。提 Issue 时请自行打码。
弹窗可选：简体中文、繁體中文、English、日本語、한국어、Deutsch、Tiếng Việt、ไทย。
- 厂家管理 — 通路与 Key
- 模型管理 — 虚拟组与 Failover
- 应用管理 — 工具接管
- 统一入口 — 网关状态
- Token 统计 — 用量
- 首次启动自动 JSON → SQLite 迁移
- 推荐重新确认 统一入口 与各工具接管状态
- Codex 保留 ID / api_key 规则见上
- 流式 中途 Failover 有限
- 模型看板部分字段可能仍在完善
- 细节见
docs/PRD_V2_CHECKLIST.md与 Release Notes
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/ |
| 主库 | aigateway.db |
| 全通道耗尽错误码 | model_group_all_exhausted |
AIGateway · MIT License · Issues · Wiki Home · EN · 中文 · 日本語 · DE · VI · 繁中
AIGateway Wiki
Language / 语言
English
中文（简体）
日本語
Deutsch
Tiếng Việt
繁體中文
Links