https://gptzzz.ai/blog/ API 中转站接入、检测、选型、自建与多模型网关工程实践 zh-CN Sat, 10 Oct 2026 12:00:00 +0000 https://gptzzz.ai/blog/cc-switch-relay/ https://gptzzz.ai/blog/cc-switch-relay/ Sat, 10 Oct 2026 12:00:00 +0000 CC Switch 配中转站：Claude Code 请求地址填 https://gptzzz.ai（不带 /v1），Codex 填 https://gptzzz.ai/v1 并用 Responses。附安装、添加供应商、模型映射、切换生效、切回官方登录与常见报错。 https://gptzzz.ai/blog/new-api-docker-deploy/ https://gptzzz.ai/blog/new-api-docker-deploy/ Fri, 09 Oct 2026 12:00:00 +0000 New API 用 Docker Compose 部署：克隆官方仓库，改掉 compose 示例密码并设置 SESSION_SECRET，执行 docker compose up -d，再用 Caddy 或 Nginx 配 HTTPS。附初始化、渠道、令牌、curl 验证、升级备份与排错。 https://gptzzz.ai/blog/api-error-messages/ https://gptzzz.ai/blog/api-error-messages/ Mon, 28 Sep 2026 12:00:00 +0000 按报错原文查中转 API 报错，逐条讲清出处、成因和修法：sse stream ended without [DONE]、422 content contains prohibited words、Invalid API key、分组不允许 /v1/messages 等，附 curl 确认命令。 https://gptzzz.ai/blog/claude-api-key/ https://gptzzz.ai/blog/claude-api-key/ Wed, 17 Sep 2026 05:00:00 +0000 Claude API Key 在 Claude Console（platform.claude.com）的 Settings → API keys 创建，按预付费额度计费，完整 Key 只显示一次。本文按官方文档讲申请步骤、Claude Code 登录方式、国内地区限制与第三方中转取舍。 https://gptzzz.ai/blog/gpt-image-2-relay/ https://gptzzz.ai/blog/gpt-image-2-relay/ Wed, 17 Sep 2026 04:00:00 +0000 GPT Image 2 走中转网关时，计费、参数和报错都和文本模型不同：按张计费、size 可能被忽略、只返回 b64_json、耗时更长。本文给出必须单独验证的四项和可复制的验收流程。 https://gptzzz.ai/blog/openai-api-key-purchase/ https://gptzzz.ai/blog/openai-api-key-purchase/ Wed, 17 Sep 2026 03:00:00 +0000 OpenAI API Key 怎么获取？先分清 ChatGPT 会员和 API 是两套账户与额度，再看官方渠道需要的条件；支付走不通时，用兼容网关前要核对计价口径、模型真实性、端点覆盖和数据处理。 https://gptzzz.ai/blog/claude-code-china-access/ https://gptzzz.ai/blog/claude-code-china-access/ Wed, 17 Sep 2026 02:00:00 +0000 Claude Code 国内连不上、很慢或装不上，先分清是哪一层：安装源、API 端点、链路还是长连接。每层给出 curl 检查命令和通过标准，并说明 ANTHROPIC_BASE_URL 怎么填、“镜像站”到底指什么。 https://gptzzz.ai/blog/claude-code-relay-selection/ https://gptzzz.ai/blog/claude-code-relay-selection/ Wed, 17 Sep 2026 00:00:00 +0000 选 Claude Code 中转站不能只看价格和倍率。用协议兼容性、模型真实性、流式与工具调用、故障行为、计费透明度、数据边界、退出成本逐条实测，并给出可复制的验证命令。 https://gptzzz.ai/blog/api-model-authenticity-check/ https://gptzzz.ai/blog/api-model-authenticity-check/ Sun, 23 Aug 2026 00:00:00 +0000 中转站给的模型是真是假、有没有掺水？只问“你是谁”没用。本文把掺水拆成模型映射变化、能力缺失、质量回归、计费不符四类，用模型目录、协议能力、重复探针和账单逐项核对，并给出异常后的处理步骤。 https://gptzzz.ai/blog/api-relay-compliance-risks/ https://gptzzz.ai/blog/api-relay-compliance-risks/ Sun, 23 Aug 2026 00:00:00 +0000 API 中转站合法吗？没有一句话的答案，要看合同与上游条款、提示词里的个人信息、跨境数据传输和所在行业。本文列出八个合规维度、排查清单，以及需要升级给法务处理的情形。 https://gptzzz.ai/blog/api-relay-error-codes/ https://gptzzz.ai/blog/api-relay-error-codes/ Sun, 23 Aug 2026 00:00:00 +0000 API 中转站返回 400、401、404、422、429 或 502、503、504 时该怎么查？用一张错误码对照表判断问题出在客户端、网关还是上游，附脱敏诊断包的写法、请求 ID 的记录方法，以及停止、回滚与恢复步骤。 https://gptzzz.ai/blog/api-relay-observability/ https://gptzzz.ai/blog/api-relay-observability/ Sun, 23 Aug 2026 00:00:00 +0000 API 中转站可观测性怎么落地？先区分用户请求和上游尝试，再用 traceparent 把指标、日志、分布式追踪和账单串起来，附字段与基数策略、仪表盘与 SLO、告警校验清单，以及从症状定位到上游尝试的排障路径。 https://gptzzz.ai/blog/api-relay-pricing-multiplier/ https://gptzzz.ai/blog/api-relay-pricing-multiplier/ Sun, 23 Aug 2026 00:00:00 +0000 API 中转站倍率是分组单价相对基准价的系数，0.1x 即按基准价的 10% 计费。本文用 gpt-5.5 的真实价格，算一次 10 万输入、1 万输出的请求，对比官方价与各分组，讲清元/刀和 ¥1=$1。 https://gptzzz.ai/blog/api-relay-retry-fallback/ https://gptzzz.ai/blog/api-relay-retry-fallback/ Sun, 23 Aug 2026 00:00:00 +0000 API 重试怎么做才不会引发重试风暴？先用幂等性把关，再给重试设预算，采用指数退避加抖动，配合熔断、背压和能力兼容的 fallback。附可执行的 full jitter 示例、故障演练清单和停止与回滚步骤。 https://gptzzz.ai/blog/api-relay-security-privacy/ https://gptzzz.ai/blog/api-relay-security-privacy/ Sun, 23 Aug 2026 00:00:00 +0000 API 中转站能看到你的提示词和 API Key 吗？本文按客户端、网关、日志、上游四段讲清数据会经过哪里，列出评估供应商时要核对的隐私与日志证据，以及发现问题后怎样退出、回滚和处理泄露。 https://gptzzz.ai/blog/api-relay-stability-benchmark/ https://gptzzz.ai/blog/api-relay-stability-benchmark/ Sun, 23 Aug 2026 00:00:00 +0000 API 中转站测评怎么做？用固定负载在多个时段重复跑，逐请求记录结果，算出成功率、TTFT、P95、流式中断和 429 比例，再按报告模板写结论。附低强度测试脚本的用法；它不是压测，也不能证明 SLA。 https://gptzzz.ai/blog/api-relay-upstream-transparency/ https://gptzzz.ai/blog/api-relay-upstream-transparency/ Sun, 23 Aug 2026 00:00:00 +0000 API 中转站上游主要有四类：官方 API Key 转发（官转）、云厂商渠道、订阅号池和逆向/IDE 额度。附对照表，以及用书面询问、分组倍率、响应头、错误格式和限流行为查看上游的方法，标明哪些只是线索。 https://gptzzz.ai/blog/api-zhongzhuan-how-to-use/ https://gptzzz.ai/blog/api-zhongzhuan-how-to-use/ Sun, 23 Aug 2026 00:00:00 +0000 API 中转站怎么用：在控制台创建 Key，Base URL 填 https://gptzzz.ai/v1，再用 curl 发第一条请求。另附 Python、Node.js、Claude Code、Codex、Cherry Studio、CC Switch 配置和换回官方的方法。 https://gptzzz.ai/blog/api-zhongzhuan-selection-checklist/ https://gptzzz.ai/blog/api-zhongzhuan-selection-checklist/ Sun, 23 Aug 2026 00:00:00 +0000 API 中转站怎么选？先过 4 道硬门槛：协议能跑通、数据去向清楚、出问题有人负责、能撤销和导出，任一项不过就淘汰。再按模型、上游、价格、账单、稳定性和迁移打分。附可复制清单。 https://gptzzz.ai/blog/api-zhongzhuan-testing-guide/ https://gptzzz.ai/blog/api-zhongzhuan-testing-guide/ Sun, 23 Aug 2026 00:00:00 +0000 API 中转站怎么检测？接入前按协议、性能、故障、账单四层逐项验收：附可复制的最小 curl 命令、每层的通过条件、从客户端到上游的故障定位路径，以及验收报告怎么写、怎么复核。 https://gptzzz.ai/blog/claude-code-api-relay/ https://gptzzz.ai/blog/claude-code-api-relay/ Sun, 23 Aug 2026 00:00:00 +0000 Claude Code 怎么接中转 API？ANTHROPIC_BASE_URL 填网关根地址（不带 /v1），Key 用 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY，再验证模型、流式响应和工具调用，并检查密钥保护与切回官方的方法。 https://gptzzz.ai/blog/codex-cli-api-relay/ https://gptzzz.ai/blog/codex-cli-api-relay/ Sun, 23 Aug 2026 00:00:00 +0000 Codex 接中转 API：在 ~/.codex/config.toml 新增 Provider，base_url 填 https://gptzzz.ai/v1，env_key 写变量名，wire_api 用 responses。附 Windows/macOS 环境变量、VS Code 插件、桌面 App、CC Switch 与换回官方配置。 https://gptzzz.ai/blog/cursor-api-relay/ https://gptzzz.ai/blog/cursor-api-relay/ Sun, 23 Aug 2026 00:00:00 +0000 Cursor 怎么接中转 API？在设置里填自定义 API Key 并开启 Override Base URL，先用 curl 预检网关，再逐项验证聊天、Agent、Tab 和流式。附三类 Key 的区别、常见报错和切回官方的方法。 https://gptzzz.ai/blog/deepseek-api-relay/ https://gptzzz.ai/blog/deepseek-api-relay/ Sun, 23 Aug 2026 00:00:00 +0000 DeepSeek 官方 Base URL 是 https://api.deepseek.com，经 GPTZZZ 中转填 https://gptzzz.ai/v1。附官方模型名 deepseek-flash、deepseek-v4-pro 与 GPTZZZ 模型 ID 对照、价格，以及 curl、Python 示例和 401/402/429 排查。 https://gptzzz.ai/blog/free-vs-paid-api-relay/ https://gptzzz.ai/blog/free-vs-paid-api-relay/ Sun, 23 Aug 2026 00:00:00 +0000 免费 API 中转站适合学习和兼容测试，不适合放敏感数据或当唯一依赖。原型要设预算、留备用端点；关键业务只选数据去向、账单和支持都说得清的服务。附场景对照表和试用步骤。 https://gptzzz.ai/blog/gemini-api-relay/ https://gptzzz.ai/blog/gemini-api-relay/ Sun, 23 Aug 2026 00:00:00 +0000 经 GPTZZZ 中转 Gemini API 走 OpenAI 兼容接口：Base URL 填 https://gptzzz.ai/v1，模型填 gemini-3.8-flash。另附 Google 原生与兼容接口地址、AI Studio 免费额度与 Key 获取、Gemini CLI 接中转的限制和报错排查。 https://gptzzz.ai/blog/open-source-api-relay-selection/ https://gptzzz.ai/blog/open-source-api-relay-selection/ Sun, 23 Aug 2026 00:00:00 +0000 常见的中转站源码有 New API、Sub2API、One API 和 LiteLLM 四个开源项目。本文对比它们的许可证、技术栈、部署方式、维护状态和适合场景，附官方 Docker 启动命令与上线前核验步骤。 https://gptzzz.ai/blog/openai-compatible-api-migration/ https://gptzzz.ai/blog/openai-compatible-api-migration/ Sun, 23 Aug 2026 00:00:00 +0000 OpenAI 兼容 API 怎么迁移？不只是换 Base URL：先对比 Responses 与 Chat Completions，冻结请求契约，再做影子验证、灰度切流和回滚演练，并处理好重试、密钥和日志脱敏。 https://gptzzz.ai/blog/streaming-tool-calling-compatibility/ https://gptzzz.ai/blog/streaming-tool-calling-compatibility/ Sun, 23 Aug 2026 12:00:00 +0000 API 流式输出和工具调用兼容吗？用 SSE 状态机对齐 Anthropic、Responses 和 Chat Completions 三种协议，跑 12 组回归测试，检查分帧、工具参数聚合、错误结束和用量，不兼容时按清单降级。 https://gptzzz.ai/blog/self-host-api-relay-architecture/ https://gptzzz.ai/blog/self-host-api-relay-architecture/ Sun, 23 Aug 2026 12:00:00 +0000 API 中转站搭建有两条路：直接部署 New API、LiteLLM 等开源源码，或按控制面与数据面自研网关。本文讲清反向代理、鉴权、路由、流式转发、Token 计量、限流熔断与运维检查。 https://gptzzz.ai/blog/openai-api-quickstart/ https://gptzzz.ai/blog/openai-api-quickstart/ Fri, 07 Aug 2026 12:00:00 +0000 OpenAI API 怎么接入？Base URL 只写到 /v1，API Key 放进环境变量，先用一条 curl 跑通第一个请求，再换成 Python SDK 并验证流式输出。附 Responses API 基线、兼容接口的差异，以及 401、404、429 报错的处理方法。 https://gptzzz.ai/blog/api-zhongzhuan-guide/ https://gptzzz.ai/blog/api-zhongzhuan-guide/ Fri, 07 Aug 2026 12:00:00 +0000 API 中转站是什么？它位于客户端和模型上游之间，负责鉴权、请求转发、协议适配、模型路由和用量记录。本文讲清一条请求的完整流程，比较中转站与普通反向代理的区别，以及适合与不适合使用的场景。 https://gptzzz.ai/blog/claude-api-quickstart/ https://gptzzz.ai/blog/claude-api-quickstart/ Thu, 06 Aug 2026 12:00:00 +0000 Claude API 中转怎么接？Base URL 只填主机根地址，路径固定为 /v1/messages，Key 放在请求头。附 curl 与 Python SDK 的第一条 Messages 请求、流式输出到 message_stop 的验证，以及 401、429、529 的处理。 https://gptzzz.ai/blog/api-key-security/ https://gptzzz.ai/blog/api-key-security/ Wed, 05 Aug 2026 12:00:00 +0000 API Key 不该出现在前端、代码仓库和日志里。本文讲服务端存储、按项目拆分 Key、最小权限与日志脱敏，给出双 Key 无中断轮换和失败回滚的步骤，以及发现泄露后第一时间该做的撤销与排查。 https://gptzzz.ai/blog/ai-api-cost-control/ https://gptzzz.ai/blog/ai-api-cost-control/ Tue, 04 Aug 2026 12:00:00 +0000 AI API 成本怎么控？把每个请求的模型、输入输出 Token、缓存、重试和价格版本放进同一条记录，按项目设日预算和月预算，再用模型路由、缓存和异常告警压低费用。附可复现的成本事件与对账示例。 https://gptzzz.ai/blog/multi-model-api-gateway/ https://gptzzz.ai/blog/multi-model-api-gateway/ Mon, 03 Aug 2026 12:00:00 +0000 大模型 API 聚合平台怎么设计？讲清统一鉴权、协议适配、模型目录和路由策略如何把不同上游接到一个接口，附流式与协议兼容测试、限流熔断与计量方案、成本公式，以及本地可复现的路由与 fallback 示例。