API 基础
OpenAI 兼容中转 API:端点、鉴权、线路、Key 分类与错误码。
GetToken 提供 OpenAI-compatible 的中转 API。主要使用方式是把它配到 Codex 等工具里(见「接入与配置」);这一页供需要直接调用 HTTP 接口的开发者参考,做简化说明。
鉴权
所有请求使用 Authorization: Bearer <API Key>。API Key 在控制台创建,文本、生图、视频使用专用 Key,不能混用。
端点
| 端点 | 用途 |
|---|---|
/v1/chat/completions | 对话补全 |
/v1/responses | Responses API(Codex 使用) |
/v1/images/generations、/v1/images/edits | 图片生成 |
/v1/videos/generations 等 | 视频生成(见「视频生成 API」) |
/v1/user/balance | 余额 / 额度查询(CC Switch 用量查询使用) |
线路
- 标准:
https://api.gettoken.dev - 中国地区优化:
https://api.clawto.link
错误码
| 状态码 | 含义 | 处理建议 |
|---|---|---|
401 | 鉴权失败 | 检查 API Key 是否完整、是否被删除 |
403 | 无权限 / 额度策略拒绝 | 检查 Key 权限与「仅使用订阅额度」设置 |
429 | 请求过于频繁或额度耗尽 | 稍后重试;检查限流设置与余额 |
503 | 服务暂不可用 | 稍后重试;如持续异常联系支持 |
完整协议细节以实际响应为准;模型名、base URL 以控制台展示为准。