GPTZZZ AI API 文档

GPTZZZ 接入参数与计费核对

服务域名为 https://gptzzz.ai。OpenAI 兼容客户端的 Base URL 使用 https://gptzzz.ai/v1；Claude 客户端应使用对应协议的配置方式，不能直接套用 OpenAI 的请求体。

接入项目	参数或路径	需要另行确认
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、计费单位及倍率；如控制台与模型广场不一致，以控制台为准，或联系技术支持确认。

接入前先确认四项信息

1. Base URL：复制控制台当前显示的接口地址，不根据第三方教程猜测。
2. API Key：只保存在服务端密钥管理或本机环境变量中。
3. 模型 ID：使用控制台实际可选的精确标识，不用模型昵称代替。
4. 请求能力：按当前路由说明核对流式输出、工具调用、上下文和限额。

鉴权最小示例

下面只演示通用 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 插件配置

错误排查顺序

1. 先记录 UTC 时间、请求 ID、模型 ID 和 HTTP 状态码。
2. 确认 Base URL、鉴权头和模型 ID 没有多余空格或旧配置。
3. 用最小请求复现，再逐项恢复流式、工具和长上下文参数。
4. 对照错误码排查手册，仍不能定位时转到技术支持。

兼容接口的最小集成路径

1. 在控制台确认当前 Base URL、精确模型 ID 和可用额度，并为测试单独创建 API Key。
2. 先用 curl 发送一个非流式最小请求，保存 HTTP 状态、响应头中的请求标识和完整错误类型。
3. 最小请求成功后再接入 SDK；只替换文档明确支持的地址与密钥配置，不同时改动重试、代理和业务参数。
4. 逐项增加流式、工具调用、长上下文或并发，每次只改变一个变量并记录结果。
5. 接入完成后撤销临时密钥，配置服务端密钥注入、超时、重试上限和用量告警。

请求诊断字段怎么记录

排障记录应包含 UTC 时间、客户端与版本、请求路径、模型 ID、流式开关、HTTP 状态、错误类型、请求 ID 和耗时。请求正文只保留可复现所需的最小字段，并删除提示词、附件、个人信息与完整鉴权头。401/403 先检查密钥与权限，429 检查限额和退避，5xx 或超时再结合服务状态区分入口、网关与上游。

上线前的安全与回归检查

把最小非流式请求、流式完成事件、错误码、用量字段和密钥撤销纳入自动化回归。确认日志默认不记录完整请求体与 Authorization，浏览器端没有密钥，重试不会跨越不可重复的业务操作。继续阅读API Key 安全指南与错误码分层排查，再根据实际流量设置监控阈值。