GPTZZZgptzzz.ai
TOPIC

AI API 接入教程合集与工具配置

这套 AI API 接入教程合集从 API 中转站的 Base URL、API Key、模型 ID 和协议格式讲起，覆盖最小请求、流式响应、工具调用与多模态验证。

本专题给出 OpenAI、Claude、Gemini、DeepSeek、Codex CLI、Claude Code 与 Cursor 的配置入口，并把 401、404、429、模型不存在和流式中断放进同一套验收流程。

AI API 接入路线包含填写 Base URL、保护 API Key、选择模型协议和验证流式工具调用
模型与客户端接入依次确认 Base URL、API Key、模型和协议，再验证流式输出与工具调用。
CONFIGURATION PATH

先按协议和客户端选择教程

同一个 Base URL 不能自动证明所有协议都兼容。选择教程前，先确认客户端发送的请求格式、鉴权头、模型 ID 和流式事件。

  1. OpenAI 与 ChatGPT API 接入

    从 API Key、Base URL、Responses/兼容端点和 Python 请求开始，逐项验证状态码、流式结束与用量字段。

  2. Claude 中转与 Messages API

    使用 x-api-key 和 Anthropic Messages 协议验证内容块、stop_reason、usage 与 request-id；Claude Code 由独立教程承接。

  3. Gemini 原生与兼容调用

    原生接口和 OpenAI 兼容层分别配置，不能混用鉴权、请求路径、流式终点或高级功能参数。

  4. Codex、Claude Code 与 Cursor 工具配置

    命令行与编辑器还要验证 Provider、环境变量、工具调用、数据路径和失败回退，不能只看普通聊天是否成功。

START HERE

建议阅读顺序

先完成三条主线，再按具体问题查看本专题全部文章。

  1. 发出第一个 API 请求

    用测试密钥、Base URL 和模型 ID 验证端点。

  2. 接入主流模型协议

    分别验证 OpenAI 兼容与 Claude Messages API。

  3. 迁移并保留回滚

    比较协议差异，灰度切换 OpenAI 兼容 API。

TOPIC GUIDES

本专题 15 篇指南

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 网关选型
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 中转
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 网关配置
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
OpenAI 兼容 API 迁移从冻结协议契约到影子验证、灰度切流和一键回滚的门禁图接入教程
约 10 分钟

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

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

OpenAI 兼容 API 迁移OpenAI Base URL 切换Responses API 迁移
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 常见报错原文速查：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 报错原文
FAQ

AI API 接入教程合集与工具配置常见问题

API Base URL 是什么，应该怎么填？

Base URL 是客户端请求的基础端点，是否包含版本路径取决于网关和 SDK。先用最小 curl 请求验证，步骤见：API 中转站使用教程。

同一个 API Key 可以直接用于所有客户端吗？

只有客户端支持自定义端点且协议兼容时才可以；密钥应放在环境变量或服务端，不要写入前端代码。查看：API Key 安全指南。

接入后为什么聊天可用但工具调用失败？

兼容层可能只实现基础文本接口，需单独检查流式事件、工具调用 ID、参数分片、并行调用与取消。按：流式和工具调用测试。