API 中转站是什么、怎么用、怎么选：完整使用指南¶
API 中转站是位于 AI 客户端与模型接口之间的兼容服务。 用户仍然通过 Base URL、API Key 和模型 ID 发起请求，但请求先到兼容服务，再由服务按其公开能力完成转发、计费和使用记录。它适合需要统一接入多个模型、使用国内支付方式或集中查看调用记录的开发者；是否适合长期使用，必须通过协议、功能、计费、安全和稳定性测试判断。
本文不提供未经持续核验的排行榜。价格和模型状态变化很快，选择前应查看服务当前公开页面，并用小额真实任务验证。
API 中转站、官方 API 和聊天订阅有什么区别¶
| 方式 | 主要用途 | 常见认证 | 应重点核验 |
|---|---|---|---|
| 聊天订阅 | 在官方网页或客户端中对话 | 账号登录 | 产品额度、客户端功能、地区要求 |
| 官方 API | 在程序和第三方工具中调用模型 | 官方 API Key | 模型权限、账单、速率限制、数据政策 |
| 兼容 API / 中转服务 | 用统一入口连接模型和工具 | 服务生成的 API Key | 协议兼容、模型能力、计费、稳定性、退出方案 |
聊天订阅通常不等于 API 额度，API Key 也不是网页登录密码。先看订阅、官方 API 与兼容 API 怎么选，再决定接入方式。
API 中转站怎么用¶
接入通常需要四项信息：
- Base URL：请求入口，例如
https://api.example.com/v1； - API Key：认证凭据，只应保存在本机环境变量或密钥管理系统；
- 模型 ID：接口真实接受的模型名称，不要凭宣传名猜测；
- 协议：常见为 OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages。
推荐顺序：
- 在服务公开页面确认目标工具所需协议；
- 创建一把仅用于测试的 Key，并设置较低额度或使用范围；
- 先查询模型或复制服务公开的模型 ID；
- 用最小请求确认认证、路径和模型都正确；
- 再测试流式输出、工具调用、图片、长上下文等业务需要的能力；
- 核对调用记录、Token 用量和余额变化；
- 验证完成后再接入 Codex、Claude Code、Cursor 或其他客户端。
Base URL 是否包含 /v1、工具是否自动拼接路径，必须以服务和工具当前说明为准。详细原理见 API Base URL、Key、模型 ID 与协议。
API 中转站怎么选¶
不要只比较首页单价。长期使用前至少检查以下六项：
1. 协议是否匹配¶
- Codex 类工具通常需要 OpenAI Responses 兼容能力；
- Claude Code 需要 Anthropic Messages 兼容能力；
- 普通聊天客户端常使用 Chat Completions，但 Agent、工具调用和流式事件还要单独测试。
“OpenAI-compatible”不代表所有字段、事件和工具能力都完全一致。
2. 能力是否真实可用¶
分别验证纯文本、流式输出、工具调用、图片输入、长上下文和 Usage 字段。不要用一次聊天成功代替完整验收。可直接使用兼容 API 上线验收清单。
3. 计费是否可核对¶
确认输入、输出、缓存、图片或其他计费单位，查看每次调用是否能对应到模型、Token 和扣费。用自己的短请求计算一次预期费用，再与账单记录比较。成本公式和 Agent 场景见 Token、上下文与 Agent 成本。
4. 稳定性是否适合业务¶
在不同时段运行相同测试，记录成功率、首字延迟、总耗时和错误类型。持续任务还要测试并发、429、流中断和重试，不能只看单次测速。
5. 安全和数据边界是否清楚¶
- Key 能否限制额度、模型或有效期；
- 是否提供删除、轮换和调用记录；
- 是否公开日志、内容保留和隐私说明；
- 是否能在发现泄露后立即吊销 Key；
- 是否避免要求用户提交账号密码、会话 Cookie 或其他不必要凭据。
6. 是否有退出方案¶
保存标准化配置、模型映射和用量记录，避免把应用写死在单一私有字段上。正式接入前确认如何导出账单、替换 Base URL、轮换 Key 和迁移模型。
最小请求验证¶
先不要把真实 Key 写进命令历史。下面示例使用环境变量和占位模型：
export AI_BASE_URL="https://api.example.com/v1"
read -rsp "API Key: " AI_API_KEY
echo
curl -sS "$AI_BASE_URL/chat/completions" \
-H "Authorization: Bearer $AI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "model-id-from-current-model-list",
"messages": [{"role": "user", "content": "只回复 OK"}],
"stream": false
}'
unset AI_API_KEY
如果目标工具需要 Responses 或 Messages，必须换成对应协议测试，不能因为 Chat Completions 成功就判断 Codex 或 Claude Code 一定可用：
常见错误排查¶
| 现象 | 优先检查 | 不建议做法 |
|---|---|---|
| 401 Unauthorized | Key 是否完整、环境变量是否生效、认证头是否正确 | 把完整 Key 发到群聊或 Issue |
| 403 Forbidden | Key 是否有模型权限、账户或项目范围是否正确 | 无限重试权限错误 |
| 404 Not Found | Base URL、/v1、endpoint 和模型 ID |
随机添加或删除路径直到偶然成功 |
| 429 Too Many Requests | 速率限制、并发量、重试间隔和额度 | 所有请求立即同时重试 |
| 5xx / 超时 | 服务状态、请求规模、流式连接和网络路径 | 把同一失败请求无上限循环 |
| 聊天成功但 Agent 失败 | Responses/Messages、工具调用、SSE 事件和 Usage | 只测普通聊天就直接上线 |
完整诊断流程见 401、404、429 与连接失败排错手册。
安全使用清单¶
- Key 只保存在环境变量或受控密钥系统；
- 测试 Key 设置最低必要权限和额度；
- 日志、截图和报错中不出现完整 Key；
- 客户端只安装可信来源的版本；
- 正式使用前核对隐私、退款、数据保留和联系渠道；
- 定期轮换 Key，发现泄露立即吊销；
- 保留替换 Base URL 和模型 ID 的迁移步骤。
常见问题 FAQ¶
API 中转站是不是换一个 Base URL 就能用¶
不一定。Base URL 只是入口，目标工具需要的协议、认证头、模型 ID、流式事件和工具调用也必须兼容。普通聊天成功不代表编程 Agent 一定可用。
API 中转站和反向代理是一回事吗¶
日常搜索中两者经常混用，但实现可能不同。判断时不要依赖名称，应查看它公开支持的 endpoint、认证、能力、计费和数据处理方式。
Codex 和 Claude Code 能共用同一个配置吗¶
通常不能直接共用。Codex 与 Claude Code 的配置文件、环境变量和主要协议不同，应分别按对应教程验证。
价格最低的 API 中转站是不是最划算¶
不能只看标价。还要核对 Token 口径、缓存、失败请求、模型能力、成功率和账单透明度。低价但频繁失败或能力不完整，实际成本可能更高。
提交 API Key 给网页检测安全吗¶
只有在你明确理解检测方的数据处理方式、Key 权限和删除机制时才应考虑。更稳妥的方式是在本机用最小权限测试 Key 发送请求，完成后立即轮换或删除。
使用限制¶
本文提供通用选择和验证方法，不对任何服务的实时价格、模型来源、可用率或长期经营作保证。接口、客户端和模型能力会变化；正式使用前应重新检查服务公开页面、目标工具官方文档和实际请求结果。