Repolode
提交项目
fruitbars

fruitbars/simple-one-api

自托管的大模型统一网关，以单可执行文件提供 OpenAI、Responses 和 Anthropic 兼容接口，接入多家模型供应商。

可替代:OpenRouter

在 GitHub 查看
Star
2,344
Fork
209
未关闭 Issue
47
最近提交
上个月

这是什么？

simple-one-api 是位于客户端工具与多家大模型供应商之间的统一网关。客户端只需对接一个地址，即可使用 OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages 协议，网关会把请求路由到已配置的供应商，包括千帆、讯飞星火、腾讯混元、MiniMax 和 DeepSeek 等。

每个 Provider 可配置多个 API Key 组成号池。网关会在请求发出前估算 Token 成本，为每个 Key 与模型维护 60 秒滚动预留窗口；上游返回 429 时自动切换到其他 Key 并记录冷却与恢复时间。QPS、QPM、RPM、TPM 和并发数可在 Provider、Provider-模型、Key、Key-模型四个层级组合配置。

项目为单个可执行文件，内嵌 React 聊天界面，并提供基于 SQLite 的可视化配置台、使用统计和实时日志。另有 Wails 桌面端，启动后在本机 loopback 地址提供网关。发布形式包括 GitHub Release 归档和 amd64/arm64 Docker 镜像。

核心功能

  • 01从同一网关对外提供 OpenAI Chat Completions、Responses 和 Anthropic Messages 接口。
  • 02每个 Provider 可配置多个 API Key 号池，支持轮询、首选、随机和哈希路由。
  • 03按 Key 估算剩余 Token 容量，上游返回 429 时自动切换到其他 Key。
  • 04支持 QPS、QPM、RPM、TPM 和并发数的多层组合限流。
  • 05内置网页聊天界面和可视化配置台，可查看每个 Key 的实时状态。
  • 06配置保存在 SQLite 中，使用统计不保存提示词或响应正文。

适用场景

  • 让 Codex、Claude Code 等本地客户端共用同一个网关地址和密钥。
  • 把大流量分散到多个上游 Key，减少 429 限流错误。
  • 自建统一入口，接入多家国内大模型供应商。
  • 为小团队提供一个 OpenAI 兼容地址，并查看用量统计。

快速上手

  1. 1

    从源码构建单文件可执行程序

    ./quick_build.sh
  2. 2

    运行网关；首次安装无需 config.json

    ./simple-one-api
  3. 3

    在浏览器中打开 http://localhost:9090/ 并完成 /setup 初始化向导

使用前须知

  • 从源码构建需要 Go 1.25+、Node.js 和 pnpm。
  • 模型价格、免费额度和模型细节来自各上游供应商，可能变化，README 要求以其官方文档为准。

收录于专题

自托管应用

标签

#llm-gateway#openai-compatible#api-proxy#load-balancing#rate-limiting#self-hosted#golang

常见问题

simple-one-api 是什么？
自托管的大模型统一网关，以单可执行文件提供 OpenAI、Responses 和 Anthropic 兼容接口，接入多家模型供应商。 simple-one-api 是位于客户端工具与多家大模型供应商之间的统一网关。客户端只需对接一个地址，即可使用 OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages 协议，网关会把请求路由到已配置的供应商，包括千帆、讯飞星火、腾讯混元、MiniMax 和 DeepSeek 等。
simple-one-api 可以免费使用吗？用的什么许可证？
simple-one-api 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
simple-one-api 还在维护吗？
半年内有更新。simple-one-api 最近一次提交是在 2026年9月29日。
simple-one-api 适合用来做什么？
让 Codex、Claude Code 等本地客户端共用同一个网关地址和密钥。 把大流量分散到多个上游 Key，减少 429 限流错误。 自建统一入口，接入多家国内大模型供应商。 为小团队提供一个 OpenAI 兼容地址，并查看用量统计。
simple-one-api 怎么安装和运行？
从源码构建单文件可执行程序: ./quick_build.sh 运行网关；首次安装无需 config.json: ./simple-one-api 在浏览器中打开 http://localhost:9090/ 并完成 /setup 初始化向导
在哪里获取 simple-one-api？
源代码和安装说明在 GitHub 上：https://github.com/fruitbars/simple-one-api

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目