GPTZZZgptzzz.ai
GPTZZZ · API RELAY FIELD GUIDE

API 中转站教程与接入指南

这套 API 中转站教程从客户端与上游模型之间的请求转发、密钥鉴权、协议适配、模型路由和用量记录讲起，并用 36 篇中文指南说明怎么选、怎么检测、怎么接入，以及什么时候值得自建。

先看中转站原理按知识地图选文章
API 中转站知识路线包含理解原理、完成选型检测、接入模型客户端和安全稳定运行
路线图把 API 中转站的四个核心阶段放在同一张图中：理解中转原理，完成选型与检测，接入模型和客户端，再以安全、稳定与成本控制持续运行。
REQUEST ROUTE

跟着一次 API 请求读懂中转站

从客户端配置一路读到网关架构，每一步都对应一组可执行指南。

  1. 入门

    理解请求从哪里开始，中转站解决哪些转发与鉴权问题。

  2. 选型

    核对 Base URL、模型、倍率、上游渠道和退出成本。

  3. 测试

    验证协议、模型身份、时延、稳定性、流式响应与账单。

  4. 接入

    连接 OpenAI、Claude、Gemini、DeepSeek、Codex 与 Cursor。

  5. 安全

    保护 API Key、提示词、日志、权限和数据边界。

  6. 架构

    拆分鉴权、协议适配、模型路由、熔断、计量与可观测性。

TOPICS

按问题进入专题

不知道具体文章名时，从当前要解决的问题开始。

选型与检测原理、价格、稳定性、上游与风险 模型与客户端接入OpenAI、Claude、Gemini、Codex 与 Cursor 生产工程安全、协议、可观测性、重试与成本 自建部署架构拆分、源码选型与长期运维
ALL GUIDES

全部 36 篇指南

当前显示 36 / 36 篇
自建 AI API 网关路线包含拆分控制面、构建数据面、适配协议路由和接入计量观测自建部署
约 15 分钟

New API Docker 部署教程：自建 AI API 中转站

New API 用 Docker Compose 部署：克隆官方仓库，改掉 compose 示例密码并设置 SESSION_SECRET，执行 docker compose up -d，再用 Caddy 或 Nginx 配 HTTPS。附初始化、渠道、令牌、curl 验证、升级备份与排错。

New APIDocker 部署中转站搭建
中转 API 常见报错原文速查：SSE 未收到 DONE、密钥无效、分组不允许端点、参数取值不支持四类报错及其定位方向接入教程
约 15 分钟

中转 API 报错速查：sse stream ended without [DONE] 等

按报错原文查中转 API 报错，逐条讲清出处、成因和修法：sse stream ended without [DONE]、422 content contains prohibited words、Invalid API key、分组不允许 /v1/messages 等，附 curl 确认命令。

sse stream ended without [DONE]中转 API 报错API 报错原文
Three walls between you and a working Claude API key: subscription confusion, billing checks, and the wrong auth header接入教程
约 8 分钟

Claude API Key 怎么获取？官方申请与国内替代方案

Claude API Key 在 Claude Console（platform.claude.com）的 Settings → API keys 创建，按预付费额度计费，完整 Key 只显示一次。本文按官方文档讲申请步骤、Claude Code 登录方式、国内地区限制与第三方中转取舍。

Claude API keyhow to get Claude API keyClaude Code API key
Claude Code 国内接入三项基线指标：TLS 握手、首字节时间、五次抖动，附稳定链路与高抖动链路的对比接入教程
约 13 分钟

Claude Code 国内使用：连不上、慢、安装失败怎么办

Claude Code 国内连不上、很慢或装不上，先分清是哪一层：安装源、API 端点、链路还是长连接。每层给出 curl 检查命令和通过标准，并说明 ANTHROPIC_BASE_URL 怎么填、“镜像站”到底指什么。

Claude Code 国内中转Claude Code 延迟优化LLM 调用重试策略
Claude Code 中转站四项核对信息图：协议兼容、工具调用、长上下文、计费透明，任一项不过即不必比较价格接入教程
约 10 分钟

Claude Code 中转站怎么选：九项可验证的判断标准

选 Claude Code 中转站不能只看价格和倍率。用协议兼容性、模型真实性、流式与工具调用、故障行为、计费透明度、数据边界、退出成本逐条实测，并给出可复制的验证命令。

Claude Code 中转站推荐Claude Code 中转站怎么选Claude Code 网关选型
回答“API 中转站倍率是什么意思”的请求级费用复算中文信息图，包含分类用量乘当前单价、应用公开倍率与附加项、用 request ID 核对扣费、异常时冻结并回滚规则四个判断点入门指南
约 7 分钟

API 中转站倍率是什么意思？附 gpt-5.5 算价例子

API 中转站倍率是分组单价相对基准价的系数，0.1x 即按基准价的 10% 计费。本文用 gpt-5.5 的真实价格，算一次 10 万输入、1 万输出的请求，对比官方价与各分组，讲清元/刀和 ¥1=$1。

API 中转站倍率是什么意思API 中转站价格API 中转站 Token 计费
回答“免费 API 中转站和付费服务怎么选”的免费与付费服务决策中文信息图，包含先按数据场景分流、再核对连续性与账单、记录指标并排查失败、停止条件触发即退出四个判断点入门指南
约 4 分钟

免费 API 中转站和付费服务怎么选？按场景做决策

免费 API 中转站适合学习和兼容测试，不适合放敏感数据或当唯一依赖。原型要设预算、留备用端点；关键业务只选数据去向、账单和支持都说得清的服务。附场景对照表和试用步骤。

免费 API 中转站和付费服务怎么选免费 API 中转站付费 API 中转服务
Cursor BYOK 从 Settings 保存供应商 Key、验证聊天模型、经过 Cursor 后端到网关预检和网络诊断的四步边界接入教程
约 12 分钟

Cursor 中转 API 配置：API Key、Base URL 与功能限制

Cursor 怎么接中转 API？在设置里填自定义 API Key 并开启 Override Base URL，先用 curl 预检网关，再逐项验证聊天、Agent、Tab 和流式。附三类 Key 的区别、常见报错和切回官方的方法。

Cursor 配置中转 APICursor API 中转Cursor API 中转站
Gemini API 原生 Interactions 与 OpenAI 兼容层分别配置鉴权、请求路径和完成事件的双协议边界接入教程
约 16 分钟

Gemini API 中转接入：接口地址、API Key 与调用示例

经 GPTZZZ 中转 Gemini API 走 OpenAI 兼容接口：Base URL 填 https://gptzzz.ai/v1，模型填 gemini-3.8-flash。另附 Google 原生与兼容接口地址、AI Studio 免费额度与 Key 获取、Gemini CLI 接中转的限制和报错排查。

Gemini API 中转站Gemini API 中转Google Gemini API 中转
API 中转站合规判断图，依次核对合同条款、数据、跨境处理与审计行业边界入门指南
约 11 分钟

API 中转站合法吗？合同、数据与地区合规风险怎么判断

API 中转站合法吗？没有一句话的答案，要看合同与上游条款、提示词里的个人信息、跨境数据传输和所在行业。本文列出八个合规维度、排查清单，以及需要升级给法务处理的情形。

API 中转站合法吗API 中转站合规风险API 中转站数据合规
Claude Code 中转站从本地工作区经过兼容网关到模型上游并执行验证与回退的信任边界图接入教程
约 9 分钟

Claude Code 中转站配置：API、Base URL 与验证

Claude Code 怎么接中转 API？ANTHROPIC_BASE_URL 填网关根地址（不带 /v1），Key 用 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY，再验证模型、流式响应和工具调用，并检查密钥保护与切回官方的方法。

Claude Code 中转站配置Claude Code API 中转站Claude Code 网关配置
API 中转站安全隐私从客户端最小化到网关处理、日志脱敏和上游审计的信任边界图入门指南
约 10 分钟

API 中转站安全吗？隐私、日志与供应商评估清单

API 中转站能看到你的提示词和 API Key 吗？本文按客户端、网关、日志、上游四段讲清数据会经过哪里，列出评估供应商时要核对的隐私与日志证据，以及发现问题后怎样退出、回滚和处理泄露。

API 中转站安全吗API 中转站隐私风险API 中转站日志保留
API 重试机制依次执行幂等门禁、限制预算、退避熔断和兼容回退工程实践
约 8 分钟

API 重试机制：退避、熔断与兼容回退设计

API 重试怎么做才不会引发重试风暴？先用幂等性把关，再给重试设预算，采用指数退避加抖动，配合熔断、背压和能力兼容的 fallback。附可执行的 full jitter 示例、故障演练清单和停止与回滚步骤。

API 重试机制API 重试策略指数退避
API 中转站可观测性从定义边界、关联信号、定位上游尝试到复盘对账的四步流程工程实践
约 8 分钟

API 中转站可观测性：指标、日志、追踪与告警

API 中转站可观测性怎么落地？先区分用户请求和上游尝试，再用 traceparent 把指标、日志、分布式追踪和账单串起来，附字段与基数策略、仪表盘与 SLO、告警校验清单，以及从症状定位到上游尝试的排障路径。

API 中转站可观测性API 可观测性API 监控
API 中转站错误码排查依次保存证据、识别层级、判断副作用并选择动作工程实践
约 6 分钟

API 中转站错误码：400、401、404、422、429 与 5xx 排查

API 中转站返回 400、401、404、422、429 或 502、503、504 时该怎么查？用一张错误码对照表判断问题出在客户端、网关还是上游，附脱敏诊断包的写法、请求 ID 的记录方法，以及停止、回滚与恢复步骤。

API 中转站错误码HTTP 错误码API 401 错误
API 中转站稳定性测试从固定负载、采集事件、计算分位到分层解释的四步基线入门指南
约 7 分钟

API 中转站测评：稳定性测试方法、指标与报告模板

API 中转站测评怎么做？用固定负载在多个时段重复跑，逐请求记录结果，算出成功率、TTFT、P95、流式中断和 429 比例，再按报告模板写结论。附低强度测试脚本的用法；它不是压测，也不能证明 SLA。

API 中转站稳定性测试API 稳定性测试API 中转站测评
API 流式输出与工具调用从 SSE 分帧到调用聚合、工具结果和完成或错误的协议状态机图工程实践
约 10 分钟

API 流式输出与工具调用兼容性：SSE 状态机测试

API 流式输出和工具调用兼容吗？用 SSE 状态机对齐 Anthropic、Responses 和 Chat Completions 三种协议，跑 12 组回归测试，检查分帧、工具参数聚合、错误结束和用量，不兼容时按清单降级。

API 流式输出与工具调用兼容性SSE 状态机Anthropic Messages 流式
回答“API 中转站怎么用”的API 中转站首次接入中文信息图，包含隔离测试 Key、确认 URL 与模型 ID、验证响应错误和用量、撤销测试 Key 再迁移四个判断点入门指南
约 10 分钟

API 中转站怎么用？3 步配好 Base URL 和 Key

API 中转站怎么用：在控制台创建 Key，Base URL 填 https://gptzzz.ai/v1，再用 curl 发第一条请求。另附 Python、Node.js、Claude Code、Codex、Cherry Studio、CC Switch 配置和换回官方的方法。

API 中转站怎么用API 中转站配置API 中转站 Base URL
DeepSeek API 按客户端 URL 字段语义配置 chat completions、当前模型 ID 与流式结束的四步请求边界接入教程
约 13 分钟

DeepSeek API 中转接入：Base URL、模型名与调用示例

DeepSeek 官方 Base URL 是 https://api.deepseek.com，经 GPTZZZ 中转填 https://gptzzz.ai/v1。附官方模型名 deepseek-flash、deepseek-v4-pro 与 GPTZZZ 模型 ID 对照、价格，以及 curl、Python 示例和 401/402/429 排查。

DeepSeek API 中转站DeepSeek API 中转DeepSeek Base URL
API 中转站搭建架构图，展示鉴权反向代理、路由流式转发、计量限流熔断与可观测性自建部署
约 12 分钟

API 中转站搭建教程：从反向代理到 AI API 网关架构

API 中转站搭建有两条路：直接部署 New API、LiteLLM 等开源源码，或按控制面与数据面自研网关。本文讲清反向代理、鉴权、路由、流式转发、Token 计量、限流熔断与运维检查。

API 中转站搭建API 中转站搭建教程自建 API 中转站
回答“API 中转站怎么选”的API 中转站选型闭环中文信息图，包含先过四项硬门槛、同条件验证六维证据、保存指标与排障结论、预设退出与复测触发四个判断点入门指南
约 5 分钟

API 中转站怎么选？可直接复制的选型清单

API 中转站怎么选？先过 4 道硬门槛：协议能跑通、数据去向清楚、出问题有人负责、能撤销和导出，任一项不过就淘汰。再按模型、上游、价格、账单、稳定性和迁移打分。附可复制清单。

API 中转站怎么选API 中转站选择清单API 中转站选型
API 模型检测依次保存目录、验证能力、重复探针和交叉核账的证据链入门指南
约 8 分钟

中转站模型真假与掺水检测：怎么核对是不是你付费的模型

中转站给的模型是真是假、有没有掺水？只问“你是谁”没用。本文把掺水拆成模型映射变化、能力缺失、质量回归、计费不符四类，用模型目录、协议能力、重复探针和账单逐项核对，并给出异常后的处理步骤。

API 模型检测中转站模型检测模型身份核验
回答“API 中转站上游渠道怎么判断”的上游透明度证据链中文信息图，包含核对模型与协议映射、关联请求数据和账单、冲突时降级并排障、记录路由变更与退出四个判断点入门指南
约 12 分钟

API 中转站上游渠道有哪些？官转、号池、逆向怎么分辨

API 中转站上游主要有四类：官方 API Key 转发（官转）、云厂商渠道、订阅号池和逆向/IDE 额度。附对照表，以及用书面询问、分组倍率、响应头、错误格式和限流行为查看上游的方法，标明哪些只是线索。

API 中转站上游渠道怎么判断API 上游中转 API 上游
OpenAI 兼容 API 迁移从冻结协议契约到影子验证、灰度切流和一键回滚的门禁图接入教程
约 10 分钟

OpenAI 兼容 API 迁移：Responses、Base URL 与回滚

OpenAI 兼容 API 怎么迁移？不只是换 Base URL：先对比 Responses 与 Chat Completions，冻结请求契约，再做影子验证、灰度切流和回滚演练，并处理好重试、密钥和日志脱敏。

OpenAI 兼容 API 迁移OpenAI Base URL 切换Responses API 迁移
回答“API 中转站是什么”的API 中转站工作链路中文信息图，包含统一 API 入口、鉴权路由与计量、协议边界逐项实测、记录指标故障与退出四个判断点入门指南
约 6 分钟

API 中转站是什么？原理与请求流程

API 中转站是什么？它位于客户端和模型上游之间，负责鉴权、请求转发、协议适配、模型路由和用量记录。本文讲清一条请求的完整流程，比较中转站与普通反向代理的区别，以及适合与不适合使用的场景。

API 中转站是什么API 中转站原理AI 中转站
OpenAI 兼容 API 从 Base URL、Bearer API Key 到 chat completions、流式输出和用量验证的四步请求路径接入教程
约 12 分钟

OpenAI API 接入教程：Base URL 停在 /v1，每步有通过标准

OpenAI API 怎么接入？Base URL 只写到 /v1，API Key 放进环境变量，先用一条 curl 跑通第一个请求，再换成 Python SDK 并验证流式输出。附 Responses API 基线、兼容接口的差异，以及 401、404、429 报错的处理方法。

OpenAI API 接入OpenAI 兼容 APIOpenAI Base URL
Claude Messages API 从主机根 Base URL、x-api-key 到 v1 messages 请求和 message_stop 流式结束的四步边界接入教程
约 13 分钟

Claude API 中转接入：Messages 请求与 Python 示例

Claude API 中转怎么接？Base URL 只填主机根地址，路径固定为 /v1/messages，Key 放在请求头。附 curl 与 Python SDK 的第一条 Messages 请求、流式输出到 message_stop 的验证，以及 401、429、529 的处理。

Claude API 接入Claude API 中转Claude Messages API
API Key 从创建与授权到受控注入、监控轮换和撤销复盘的安全生命周期图工程实践
约 10 分钟

API Key 安全：存储、权限、轮换与响应

API Key 不该出现在前端、代码仓库和日志里。本文讲服务端存储、按项目拆分 Key、最小权限与日志脱敏，给出双 Key 无中断轮换和失败回滚的步骤，以及发现泄露后第一时间该做的撤销与排查。

API Key 安全AI API 密钥管理API Key 最小权限
AI API 成本控制信息图：计量真实用量、预算事前拦截、异常实时止损与账单周期对账工程实践
约 14 分钟

AI API 成本控制：Token 费用、预算与告警

AI API 成本怎么控？把每个请求的模型、输入输出 Token、缓存、重试和价格版本放进同一条记录，按项目设日预算和月预算，再用模型路由、缓存和异常告警压低费用。附可复现的成本事件与对账示例。

AI API 成本控制Token 成本Token 成本计算
多模型 API 网关封面，展示身份策略、能力路由、协议适配与观测计量四个核心组件工程实践
约 8 分钟

大模型 API 聚合平台：统一接口、路由与故障切换

大模型 API 聚合平台怎么设计？讲清统一鉴权、协议适配、模型目录和路由策略如何把不同上游接到一个接口，附流式与协议兼容测试、限流熔断与计量方案、成本公式，以及本地可复现的路由与 fallback 示例。

多模型 API 网关大模型 API 聚合平台大模型 API 聚合平台 GitHub
GLOSSARY

API 中转站常用术语

先统一这些概念，再阅读接入、检测和架构文章。

API 中转站
位于客户端与模型供应商之间，统一完成请求转发、鉴权、协议适配与用量记录。
AI API 网关
在转发之上增加多模型路由、限流、熔断、计量、审计和可观测性的工程层。
OpenAI 兼容 API
使用近似 OpenAI 的请求与响应格式，让现有 SDK 通过更换端点连接其他模型或网关。
Base URL
客户端发送 API 请求的基础地址；是否包含版本路径要以网关文档和实测结果为准。
Token 计费
根据输入、输出、缓存等 Token 用量和模型单价计算费用，倍率只是账单公式中的一项。
FAQ

API 中转站常见问题

API 中转站是什么？

API 中转站位于客户端与上游模型之间，负责转发请求、鉴权、协议适配、模型路由和用量记录。建议先读：API 中转站原理与用途。

API 中转站怎么选？

不要只看价格或广告排名，应核对协议兼容、模型证据、账单透明、安全、稳定性和退出成本。可直接使用：API 中转站选型清单。

怎样检测模型真实性和稳定性？

先验证模型 ID、协议能力和请求证据，再用固定样本测成功率、TTFT、P95、流式中断与账单。按：API 中转站检测流程。

Base URL 和 API Key 应该怎么配置？

Base URL 指向网关兼容端点，API Key 只应放在环境变量或服务端密钥系统中；先用最小 curl 请求验证。查看：API 中转站使用教程。

什么情况下值得自建 API 中转站？

当团队需要统一鉴权、协议适配、多模型路由、限流熔断、计量审计或数据边界时，自建网关更容易控制。参考：自建 API 中转站架构。

UPDATES

持续更新实用的 API 指南

收藏博客或订阅 RSS，及时查看新教程。

订阅 RSS