GPTZZZ AI API 文档
更新于
先确认控制台中的 Base URL、API Key、模型 ID 与当前能力，再按所用客户端完成鉴权和请求。模型、倍率、路由与限额以控制台实时信息为准。
GPTZZZ 接入参数与计费核对
服务域名为 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。
| 接入项目 | 参数或路径 | 需要另行确认 |
|---|---|---|
| OpenAI 兼容客户端 | https://gptzzz.ai/v1 | 客户端是否自动追加 /chat/completions 或 /responses，避免重复 /v1。 |
| Claude Messages 请求 | https://gptzzz.ai/v1/messages | 鉴权头用 Authorization: Bearer 或 x-api-key 均可；协议版本、模型与流式事件格式按客户端验证。 |
| 模型 ID 与能力 | 从账户分组复制精确 ID | 不能以首页模型品牌名称代替 ID；工具、流式、上下文和配额分别验证。 |
| 费用核对 | 计费单位、输入/输出单价、缓存及分组倍率 | 保留调用时价格口径与用量记录，区分示例估算和最终账单。 |
模型广场列出了当前公开的模型、分组与价格。接入前请在控制台核对账户可用的精确模型 ID、计费单位及倍率；如控制台与模型广场不一致，以控制台为准，或联系技术支持确认。
按客户端填写 Base URL
同一个域名，不同客户端会在你填的地址后面自动拼接不同路径，所以要填到不同层级。上表的 https://gptzzz.ai/v1/messages 是完整请求地址，不要填进 ANTHROPIC_BASE_URL。
| 客户端 | 填写的地址 | 客户端实际请求 |
|---|---|---|
| OpenAI SDK、Cursor 等 OpenAI 兼容客户端 | https://gptzzz.ai/v1 | /v1/chat/completions |
Codex CLI（wire_api = "responses"） | base_url = "https://gptzzz.ai/v1" | /v1/responses |
| Claude Code、Anthropic SDK | ANTHROPIC_BASE_URL=https://gptzzz.ai（不带 /v1） | /v1/messages |
走加速线路时路径层级不变，上表三种客户端只把域名换成 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 模型）可用哪些接口，以控制台为准。
接入前先确认四项信息
- Base URL：复制控制台当前显示的接口地址，不根据第三方教程猜测。
- API Key：只保存在服务端密钥管理或本机环境变量中。
- 模型 ID：使用控制台实际可选的精确标识，不用模型昵称代替。
- 请求能力：按当前路由说明核对流式输出、工具调用、上下文和限额。
鉴权最小示例
下面只演示通用 Bearer 鉴权。请把请求地址与请求体替换为控制台和对应客户端当前给出的值。
export GPTZZZ_API_KEY="<YOUR_API_KEY>"
export GPTZZZ_REQUEST_URL="<REQUEST_URL_FROM_CONSOLE>"
curl "$GPTZZZ_REQUEST_URL" -H "Authorization: Bearer $GPTZZZ_API_KEY" -H "Content-Type: application/json" --data '<REQUEST_BODY_FOR_YOUR_ROUTE>'安全边界：不要把完整 API Key 写进前端代码、截图、公开仓库、邮件或工单。需要排障时只提供脱敏前后缀。
按你的接入方式继续
- OpenAI 兼容 API 迁移：Base URL、模型映射与回滚
- OpenAI 兼容客户端接入与最小验证
- Claude API 接入：请求格式、流式输出与排错
- 流式输出和工具调用的兼容性验收方法
- 在 Vercel AI SDK 中使用 GPTZZZ：createOpenAICompatible、Responses 与 Claude 配置
- 在 Dify 中接入 GPTZZZ：GPTZZZ 插件、OpenAI-API-compatible 与 Anthropic 插件配置
错误排查顺序
- 先记录 UTC 时间、请求 ID、模型 ID 和 HTTP 状态码。
- 确认 Base URL、鉴权头和模型 ID 没有多余空格或旧配置。
- 用最小请求复现，再逐项恢复流式、工具和长上下文参数。
- 对照错误码排查手册，仍不能定位时转到技术支持。
兼容接口的最小集成路径
- 在控制台确认当前 Base URL、精确模型 ID 和可用额度，并为测试单独创建 API Key。
- 先用 curl 发送一个非流式最小请求，保存 HTTP 状态、响应头中的请求标识和完整错误类型。
- 最小请求成功后再接入 SDK；只替换文档明确支持的地址与密钥配置，不同时改动重试、代理和业务参数。
- 逐项增加流式、工具调用、长上下文或并发，每次只改变一个变量并记录结果。
- 接入完成后撤销临时密钥，配置服务端密钥注入、超时、重试上限和用量告警。
请求诊断字段怎么记录
排障记录应包含 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、倍率、流式、工具调用等一处讲清。