One API(one-api)的官方入口是它的 GitHub 仓库 github.com/songquanpeng/one-api,这是一个开源的 LLM 接口管理与分发系统,把 OpenAI、Claude、Gemini、通义千问等多家大模型的接口统一成一套 OpenAI 格式;官方在线演示在 oneapi.justsong.cn。项目采用 MIT 协议、单可执行文件加 Docker 一键部署,工具本身免费。 oneapi官网入口有哪些
"oneapi"是一个开源的 LLM 接口管理与分发系统,可以帮你更好地管理和使用各大厂商的 LLM API,它的官方入口就下面这几处:
- 官方在线演示:oneapi.justsong.cn,不用部署就能先看界面和后台长什么样(页面是前端渲染,需要浏览器执行脚本)。
- Docker 镜像:稳定版/预览版镜像 justsong/one-api(Docker Hub)或 GitHub 容器镜像库版本 ghcr.io/songquanpeng/one-api;另有 alpha 版镜像。
- 作者博客:justsong.cn,作者本人的技术笔记站点,演示地址就挂在这个域下。
注意区分:One API 本身不提供大模型能力,它只是把你手上各家模型的 API Key 汇总到一个入口统一转发,所以没有"注册账号即用"的官网,必须先自己部署。
One API怎么部署和使用
从零到跑通,一条 Docker 命令加三步配置。
- 拉起来服务。官方给的最简命令是:docker run --name one-api -d --restart always -p 3000:3000 -e TZ=Asia/Shanghai -v /home/ubuntu/data/one-api:/data justsong/one-api。其中 -p 3000:3000 的第一个 3000 是宿主机端口,可按需修改;数据与日志保存在挂载的目录里。
- 首次登录并立刻改密码。默认账号是 root、密码是 123456,README 特别强调:初次登录后务必修改默认密码,否则系统暴露在公网等于门洞大开。
- 加渠道。登录后在「渠道」页面添加你的模型 API Key,选择对应的渠道类型(如 OpenAI、Claude、通义千问),并填好该渠道可用的模型名。
- 建令牌。到「令牌」页面新建访问令牌,可设置过期时间、额度上限、允许的 IP 范围与可访问的模型。生成的 Key 就是对外分发用的凭证。
- 客户端改接入地址。把用到 OpenAI 接口的地方,API Base 设成你的部署地址(如 https://你的域名/v1),Key 填刚才生成的令牌即可,代码基本不用改。
两个进阶提示:并发量较大时务必设置 SQL_DSN 改用 MySQL 或 PostgreSQL,默认的 SQLite 扛不住高并发;如果镜像拉不动,可以把命令里的 justsong/one-api 换成 ghcr.io/songquanpeng/one-api。另外,在令牌后面加 -渠道ID(形如 Bearer 令牌-渠道ID)可以指定某次请求走哪个渠道,但这个能力只对管理员创建的令牌开放,不加则按负载均衡自动分配。
One API支持哪些模型渠道
这是选它的核心理由——把多家模型统一成一套 OpenAI 格式。官方 README 列出的渠道覆盖面很广:
| |
|---|
| OpenAI(含 Azure)、Anthropic Claude(含 AWS Claude)、Google Gemini、Mistral、Cohere、DeepL |
| 百度文心一言、阿里通义千问、讯飞星火、智谱 ChatGLM、360 智脑、腾讯混元、Moonshot、百川、MiniMax、零一万物、阶跃星辰、DeepSeek、字节豆包(火山引擎) |
| Ollama、Groq、Cloudflare Workers AI、Together AI、Novita AI、硅基流动 SiliconCloud |
| |
换模型时应用侧不用改代码,只改请求里的模型名即可,这就是"一个网关管所有模型"的价值所在。
One API的额度与计费规则
One API 工具本身免费,你在它上面花的钱实际是各家模型的调用费。它内置了一套配额与计费逻辑:
- 额度计算公式:额度 = 分组倍率 × 模型倍率 ×(提示 token 数 + 补全 token 数 × 补全倍率)。其中补全倍率对 GPT-3.5 固定为 1.33、对 GPT-4 为 2,与官方口径一致。
- 默认倍率即官方倍率,已经调整过;管理员可以在此基础上自定义模型倍率,用于加价分发。
- 令牌额度与账户额度是两回事:令牌额度只是给使用者设的使用上限,和账户余额分开计算。
也就是说,它本身不产生费用,是让费用可见化的工具——谁用了多少、哪个分组花了多少,都能在统计页里看到。
One API使用注意事项与常见报错
| | |
|---|
| | 检查用户分组与渠道分组设置,以及渠道里配置的模型列表 |
| | |
渠道测试报 invalid character '<' looking for beginning of value | | 多半是部署站 IP 或代理节点被 CloudFlare 封禁 |
ChatGPT Next Web 报 Failed to fetch | | 部署时不要设置 BASE_URL;核对接口地址与 Key;HTTPS 页面不能请求 HTTP 接口 |
| | |
- 默认密码必须改:初始密码 123456 是公开的,部署到公网前先改掉,再考虑加访问控制。
- 并发大务必设 SQL_DSN:默认 SQLite 在高并发下会成为瓶颈,改用 MySQL 或 PostgreSQL。
- 令牌额度不等于账户额度:给使用者分配的是令牌额度,两者分开计算,别混着看。
- 注意项目更新节奏与分支授权:One API 近一年多代码更新已明显放缓,社区里出现了多个基于它的衍生分支,授权协议也不一样(One API 为 MIT,部分分支改用 AGPL 等更严格协议),选型时按需求与条款评估。
- 只从官方入口进入:官方入口只此一处,建议从官方仓库页面直接进入,不要通过搜索引擎广告位或第三方下载站跳转;凡要求输入账号密码或支付信息的非官方页面都不要提交信息。
One API常见问题
Q:oneapi官网入口是哪个?
A:官方主站是 GitHub 仓库 github.com/songquanpeng/one-api,在线演示是 oneapi.justsong.cn,没有独立的商业官网。
Q:One API 是什么?需要付费吗?
A:它是一个开源的 LLM 接口管理与分发系统,把多家模型统一成 OpenAI 格式;工具本身采用 MIT 协议、免费自部署,费用只来自你调用的各家模型。
Q:最简单的部署方式是什么?
A:Docker 一条命令就能跑起,默认监听 3000 端口,启动后浏览器打开 http://你的地址:3000 进后台。
Q:默认账号密码是多少?安全吗?
A:初始账号 root、密码 123456,官方明确要求首次登录后立即改密码;直接暴露在公网而不改密码是高风险做法。
Q:支持哪些模型?
A:覆盖 OpenAI、Claude、Gemini、DeepSeek、通义千问、文心一言、讯飞星火、智谱、腾讯混元、豆包、Ollama 等主流渠道,共数十种,并支持第三方代理与镜像。 Q:额度够为什么还提示额度不足?
A:大概率是令牌额度用尽了——令牌额度和账户额度是分开算的,令牌额度只是使用者自己的上限。
Q:它会不会记录我的对话内容?
A:One API 只做转发与计量,代码开源可自行审计;实际的数据留存策略取决于你自己部署的配置和上游渠道,建议按内部数据合规要求评估。
Q:它和 New API 是什么关系?
A:New API 是社区里由 One API 衍生的分支项目,功能与更新节奏不同。One API 采用 MIT 协议,部分衍生分支改用 AGPL 等更严格的授权,选型时按需求和授权条款评估。
Q:部署和使用有技术门槛吗?
A:需要一台能跑 Docker 的服务器和基础命令行操作;上游渠道的 Key 需要你自己准备,One API 不代你开通任何模型账号。
One API 的项目状态、镜像地址与授权条款会随仓库更新变化,部署前先在官方仓库 README 里确认当期说明即可。想持续跟进 oneapi官网入口 这类开源 AI 工具的最新动态与入口变化,可以关注本站的 AI 工具栏目,有更新我们会同步整理。