API 基础

OpenAI 兼容中转 API:端点、鉴权、线路、Key 分类与错误码。

GetToken 提供 OpenAI-compatible 的中转 API。主要使用方式是把它配到 Codex 等工具里(见「接入与配置」);这一页供需要直接调用 HTTP 接口的开发者参考,做简化说明。

鉴权

所有请求使用 Authorization: Bearer <API Key>。API Key 在控制台创建,文本、生图、视频使用专用 Key,不能混用

端点

端点用途
/v1/chat/completions对话补全
/v1/responsesResponses 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 以控制台展示为准。

本页内容