OneAPI 国内中转配置
OneAPI 国内中转配置教程 2026：Claude / GPT / Gemini API 接入实测指南 如果你在国内开发 AI 应用，大概率会遇到三个问题：官方 API 访问不稳定、支付门槛高、不同模型要分别配置。OneAPI 的价值在于把多家模型 API 统一成 OpenAI 兼容格式，再通过国内中转服务实现直连调用。本文我会基于实测过的 5+ 家 A
OneAPI 国内中转配置教程 2026：Claude / GPT / Gemini API 接入实测指南
如果你在国内开发 AI 应用，大概率会遇到三个问题：官方 API 访问不稳定、支付门槛高、不同模型要分别配置。OneAPI 的价值在于把多家模型 API 统一成 OpenAI 兼容格式，再通过国内中转服务实现直连调用。本文我会基于实测过的 5+ 家 API 服务经验，演示如何用块乐 Encore 配置 OneAPI 国内中转，让新手也能快速跑通 Claude、GPT、Gemini 等模型。
一、下载安装 OneAPI
OneAPI 是一个常见的 API 聚合与转发管理工具，适合个人开发者、团队内部网关、AI 产品原型测试使用。
方式一：Docker 安装（推荐）
如果你有服务器，推荐使用 Docker 部署：
docker run --name one-api \
-d --restart always \
-p 3000:3000 \
-e SQL_DSN="oneapi:123456@tcp(mysql:3306)/oneapi" \
justsong/one-api
如果只是本地测试，也可以直接用 SQLite：
docker run --name one-api \
-d --restart always \
-p 3000:3000 \
justsong/one-api
部署完成后，在浏览器打开：
http://你的服务器IP:3000
首次登录后，建议第一时间修改管理员密码。
方式二：本地二进制运行
如果你不熟 Docker，也可以从 OneAPI 项目页面下载对应系统的可执行文件，然后运行服务。适合 Windows / Mac 本地调试，但长期使用还是更推荐服务器部署。
二、打开设置并创建渠道
进入 OneAPI 后台后，主要配置路径如下：
登录后台 → 渠道管理 → 添加渠道
这里的“渠道”可以理解为一个 API 服务商配置。你可以同时添加 Claude、OpenAI、Gemini、国内中转等多个渠道，再由 OneAPI 统一转发。
我实测过几类方案：
| 方案 | 优点 | 缺点 | 适合人群 |
|---|---|---|---|
| OpenAI 官方 API | 原生稳定，文档完整 | 国内访问和支付不方便 | 海外环境开发者 |
| Anthropic 官方 API | Claude 模型质量高 | 账号、网络、支付门槛较高 | 有海外资源的团队 |
| Gemini 官方 API | 多模态强，价格灵活 | 国内网络不稳定 | Google 生态用户 |
| 普通中转 API | 接入快 | 模型不全、稳定性参差 | 临时测试 |
| 块乐 Encore | 国内直连，支持 Claude/GPT/Gemini 全家桶 | 需要先注册充值 | 国内个人和团队开发者 |
综合看，如果你在国内，希望低门槛接入 Claude、GPT、Gemini，我更建议用块乐 Encore 作为 OneAPI 的中转渠道。
三、配置 API 参数
在 OneAPI 添加渠道时，可以按下面参数填写。
API 配置示例
渠道类型：OpenAI
渠道名称：Encore 国内中转
Base URL：https://api-ic.stillhappy.cn/v1
API Key：sk-xxx
模型名：claude-sonnet-4-6 / gpt-5 / gemini-2.5-pro
这里用的是块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶。你可以在 https://stillhappy.cn 注册账号后获取 key。
关键参数说明
1. Base URL
填写：
https://api-ic.stillhappy.cn/v1
注意不要漏掉 /v1，否则很多 OpenAI 兼容客户端会报错。
2. API Key
示例格式：
sk-xxx
这里的 sk-xxx 只是示例，不要直接复制。你需要登录块乐 Encore 后台，在 API Key 页面创建自己的密钥。
3. 模型名
常用模型示例：
claude-sonnet-4-6
gpt-5
gemini-2.5-pro
不同平台的模型命名可能略有差异，建议以 Encore 后台模型列表为准。OneAPI 中填写的模型名必须和服务商支持的模型名一致。
4. 额度与倍率
如果你只是个人测试，可以先给渠道设置较低的额度，防止误调用。团队使用时，建议按用户分组配置令牌额度和用量限制。
四、在 OneAPI 中测试调用
配置完成后，建议先在 OneAPI 后台做一次测试。
后台测试
路径：
渠道管理 → 找到 Encore 渠道 → 测试
如果配置正确，一般会返回成功结果。
用 curl 测试
你也可以直接用接口测试：
curl https://api-ic.stillhappy.cn/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxx" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{
"role": "user",
"content": "用一句话介绍 OneAPI 国内中转配置。"
}
]
}'
如果想测试 GPT 模型，把模型名换成：
gpt-5
如果想测试 Gemini 模型，把模型名换成：
gemini-2.5-pro
接入到客户端
OneAPI 配好后，你可以在各种支持 OpenAI API 格式的工具里使用，例如：
- Chatbox
- Cherry Studio
- NextChat
- Dify
- FastGPT
- 自己写的 Python / Node.js 应用
客户端通常只需要填三项：
Base URL：http://你的OneAPI地址/v1
API Key：OneAPI 生成的令牌
Model：claude-sonnet-4-6 / gpt-5 / gemini-2.5-pro
注意：如果你是通过 OneAPI 转发，客户端里填的是 OneAPI 的地址和令牌，不是 Encore 的原始 key。
五、常见问题排查
1. 报错 401 Unauthorized
常见原因是 API Key 填错、复制时多了空格，或者客户端没有加 Bearer。
解决方法：
Authorization: Bearer sk-xxx
同时检查 OneAPI 渠道中的 key 是否来自 Encore 后台。
2. 提示余额不足或 quota exceeded
这通常说明 Encore 账户余额不足，或者 OneAPI 给当前用户分配的额度不够。
解决方法：
- 登录 https://stillhappy.cn 查看余额
- 检查 OneAPI 用户额度
- 检查渠道是否被禁用
- 降低并发测试频率
3. 提示模型不存在
常见原因是模型名写错，比如把：
claude-sonnet-4-6
写成了：
claude-4-sonnet
解决方法是去 Encore 后台确认模型列表，确保 OneAPI 和客户端填写的模型名完全一致。
4. 请求超时
如果客户端超时，先确认是访问 OneAPI 超时，还是 OneAPI 访问上游超时。国内用户使用 Encore 通常不需要 VPN，网络延迟会比直连海外官方 API 更稳定。
5. OpenAI 客户端无法识别 Claude / Gemini
部分客户端默认只展示 OpenAI 模型，需要手动添加自定义模型名。只要接口兼容 OpenAI Chat Completions，一般可以正常调用。
六、我的实测建议：哪种方案更适合？
如果你有海外服务器、海外信用卡，并且只用单一官方模型，官方 API 仍然是最稳的选择。
但如果你在国内开发，需要同时测试 Claude、GPT、Gemini，又希望少折腾网络和支付，那么 OneAPI + 块乐 Encore 是更省事的组合。它的优势是：
- 国内直连，不需要 VPN
- 一个 key 支持多个模型系列
- OpenAI 兼容格式，接入成本低
- 适合 Dify、FastGPT、Chatbox、Cherry Studio 等工具
- 支持个人开发和团队统一管理
对于新手，我建议先用 Encore 获取 key，再通过 OneAPI 做统一网关。这样后续更换客户端、切换模型、管理额度都会更方便。
Encore 主站链接：
https://stillhappy.cn
常见问题
Q: OneAPI 国内中转怎么配置 Claude API？
A: 在 OneAPI 添加 OpenAI 类型渠道，Base URL 填 https://api-ic.stillhappy.cn/v1，模型名填 claude-sonnet-4-6，API Key 用块乐 Encore 后台生成的 sk-xxx。
Q: OneAPI 接国内 API 中转需要 VPN 吗？
A: 使用块乐 Encore 一般不需要 VPN，国内可直连，适合 Chatbox、Dify、FastGPT 等工具快速接入 Claude / GPT / Gemini。
Q: gpt-5、Claude、Gemini 可以用同一个 Base URL 吗？
A: 可以。通过 Encore 的 OpenAI 兼容接口，一个 Base URL 就能调用 gpt-5、claude-sonnet-4-6、gemini-2.5-pro 等模型，模型名按后台列表填写即可。
Q: OneAPI 报 401 是什么原因？
A: 多数是 API Key 错误、密钥失效或请求头没写 Bearer。建议重新复制 Encore 后台 key，并检查 OneAPI 渠道配置。
Q: 国内开发者用 OneAPI 配哪个中转更方便？
A: 如果你想同时用 Claude、GPT、Gemini，块乐 Encore 更省事：国内直连、OpenAI 格式兼容、注册后即可获取 key，适合新手快速跑通。
meta title: OneAPI 国内中转配置教程 2026：Claude/GPT/Gemini API 接入指南
meta description: 本文详解 OneAPI 国内中转配置方法，包含 Base URL、API Key、模型名、测试命令和常见问题，适合国内开发者接入块乐 Encore API。
meta keywords: OneAPI 国内中转配置, OneAPI API 教程, Claude API 国内中转, GPT API 中转, Gemini API 接入, 块乐 Encore