API 中转接入与迁移指南
本页说明已有应用如何迁移请求地址、凭据和协议。找工具设置入口请回 文档首页；模型能力比较见 多模型兼容边界。
第 1 步：确认正在使用的协议
| 协议 | 客户端基础地址 | 最终请求路径 | 请求与响应 |
|---|---|---|---|
| OpenAI Chat | https://api.apizt.com/v1 | /v1/chat/completions | messages → choices |
| OpenAI Responses | https://api.apizt.com/v1 | /v1/responses | input → output |
| Anthropic Messages / Claude CLI | https://api.apizt.com | /v1/messages | messages → content |
| Gemini 原生 / CLI | https://api.apizt.com | /v1beta/models/{model}:generateContent | contents → candidates |
这是对应客户端的填写方式。TRAE 开启完整 URL 时直接填最终路径；SDK 则通常追加端点。查看 Chat 与 Responses 对照。
第 2 步：更换 Key 与模型权限
进入 apizt 控制台 → API 令牌 → 新建，选择支持目标模型及协议的分组，设置额度后复制令牌。已有令牌可继续使用；模型目录和权限不是同一回事。查看创建分组令牌的图文步骤。
不要沿用原厂 Key。HTTP 示例使用 Authorization: Bearer；SDK 的 apiKey、Claude AUTH_TOKEN 与 Gemini API Key 参数需按对应教程传递。不要把 Key 放 URL 或公开仓库。
第 3 步：用最小请求验证迁移
export tokenba_API_KEY="YOUR_tokenba_API_KEY"
curl https://api.apizt.com/v1/chat/completions \
-H "Authorization: Bearer $tokenba_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-4o","messages":[{"role":"user","content":"Reply exactly tokenba_OK"}],"max_tokens":32}'本次 gpt-4o 返回 tokenba_OK；完整结果见 真实调用记录。Chat 成功后还需单独检查工具、JSON 输出、图片输入、流式等实际使用的功能。
第 4 步：按功能迁移和回滚
- 保留原配置，先在测试环境替换地址和凭据。
- 检查请求体、响应解析与所选协议匹配。
- 用真实业务的小样例验证，记录输出、延迟和控制台用量。
- 逐项迁移流式、工具与多模态；失败时恢复之前配置。
地址正确但调用失败
404 与重复端点 · 401、权限与模型 ID · 429、流式与费用。
按工具继续配置
Codex Responses · Claude Messages · Cursor Chat · TRAE 完整 URL。价格见 实时模型价格。