API 接入文档：Base URL、Key 鉴权与排错｜GPTZZZ

先确认控制台中的 Base URL、API Key、模型 ID 与当前能力，再按所用客户端完成鉴权和请求。模型、倍率、路由与限额以控制台实时信息为准。
服务域名为 https://gptzzz.ai。OpenAI 兼容客户端的 Base URL 使用 https://gptzzz.ai/v1；Claude 客户端应使用对应协议的配置方式，不能直接套用 OpenAI 的请求体。
加速线路 cn.gptzzz.ai：中国联通等国内网络访问或调用较慢时，把本页地址里的 gptzzz.ai 换成 cn.gptzzz.ai 即可，账号、API Key、余额和模型都与主站相同。例如 OpenAI 兼容 Base URL 填 https://cn.gptzzz.ai/v1，Claude Code 填 ANTHROPIC_BASE_URL=https://cn.gptzzz.ai。
模型广场列出了当前公开的模型、分组与价格。接入前请在控制台核对账户可用的精确模型 ID、计费单位及倍率；如控制台与模型广场不一致，以控制台为准，或联系技术支持确认。
同一个域名，不同客户端会在你填的地址后面自动拼接不同路径，所以要填到不同层级。上表的 https://gptzzz.ai/v1/messages 是完整请求地址，不要填进 ANTHROPIC_BASE_URL。
走加速线路时路径层级不变，上表三种客户端只把域名换成 cn.gptzzz.ai：https://cn.gptzzz.ai/v1、base_url = "https://cn.gptzzz.ai/v1"、ANTHROPIC_BASE_URL=https://cn.gptzzz.ai。
鉴权头：Authorization: Bearer <Key>、x-api-key: <Key> 均可；Key 不能放在 URL 查询参数里。自检：不带 Key 请求正确路径会返回 401 和 {"code":"API_KEY_REQUIRED",...}；返回 404 说明路径拼错了（常见是重复的 /v1/v1）。
每个 API Key 只属于一个分组，只能调用这个分组里的模型（见模型广场的分组一览）。OpenAI 兼容客户端和 Codex CLI 调用 GPT / Codex 模型（如 gpt-5.5），用「混合号池pro兜底」或「不降智分组」的 Key；Claude Code、Anthropic SDK 调用 Claude 模型（如 claude-sonnet-5），用「claude_kiro」分组的 Key。其余两个分组「grok heavy」（Grok 模型）和「国模」（DeepSeek、GLM 模型）可用哪些接口，以控制台为准。
下面只演示通用 Bearer 鉴权。请把请求地址与请求体替换为控制台和对应客户端当前给出的值。
排障记录应包含 UTC 时间、客户端与版本、请求路径、模型 ID、流式开关、HTTP 状态、错误类型、请求 ID 和耗时。请求正文只保留可复现所需的最小字段，并删除提示词、附件、个人信息与完整鉴权头。401/403 先检查密钥与权限，429 检查限额和退避，5xx 或超时再结合服务状态区分入口、网关与上游。
把最小非流式请求、流式完成事件、错误码、用量字段和密钥撤销纳入自动化回归。确认日志默认不记录完整请求体与 Authorization，浏览器端没有密钥，重试不会跨越不可重复的业务操作。继续阅读API Key 安全指南与错误码分层排查，再根据实际流量设置监控阈值。
接口地址、模型与额度会变化，始终以你的控制台当前信息为准。
遇到接口报错？查 AI API 错误码速查手册，按 400、401、429、5xx 对照 OpenAI、Claude、Gemini、DeepSeek 与网关的原因与修法。
不熟悉某个概念？查 AI API 术语表，Base URL、Token、TTFT、倍率、流式、工具调用等一处讲清。
AI API 中转站接入、选型、安全与工程实践。