文档目录
接口格式
Claude 用 Anthropic 原生,GPT 用 Chat Completions / Responses,其他模型用 Chat Completions。
本站提供三种接口格式,用同一把密钥、同一份余额。每个系列的模型只能使用它自己的原生格式,不做跨格式调用(例如不能用 Chat Completions 调 Claude)。
| 格式 | 路径 | 接入地址 | 鉴权方式 |
|---|---|---|---|
| Anthropic 原生 | POST /v1/messages | https://tokenwayapi.com(不带 /v1) | x-api-key 请求头 |
| OpenAI Chat Completions | POST /v1/chat/completions | https://tokenwayapi.com/v1 | Authorization: Bearer |
| OpenAI Responses | POST /v1/responses | https://tokenwayapi.com/v1 | Authorization: Bearer |
每个系列用哪种格式
| 模型系列 | 可用接口 | 不可用 |
|---|---|---|
| Claude | /v1/messages(Anthropic 原生) | /v1/chat/completions、/v1/responses |
| GPT | /v1/chat/completions、/v1/responses(Codex 这类新式工具推荐 Responses) | /v1/messages |
| 其他模型(DeepSeek、Kimi、Gemini、Grok 等) | /v1/chat/completions | /v1/messages、/v1/responses |
用错格式会怎样
请求会立即返回 400,并告诉你该模型应该改用哪个接口,例如:
用 Chat Completions 调 Claude 时的返回
{"error":{"message":"模型 claude-sonnet-5-5 不支持 /v1/chat/completions 接口,请改用 /v1/messages","type":"invalid_request_error","code":"unsupported_endpoint"}}这样做是因为跨格式转换(尤其是带工具调用的长请求)又慢又容易出错,用各自的原生格式最快也最稳。
客户端怎么对应
只支持 OpenAI 格式的客户端(例如 Cursor)可以用 GPT 和其他模型,但不能用 Claude;要用 Claude 请选支持 Anthropic 格式的客户端,如 Claude Code、Cherry Studio(Anthropic 类型服务商)或 Anthropic SDK。Claude Code 只能用 Claude 模型,Codex CLI 只能用 GPT 模型。
共同点
各格式的示例见 用 curl 测试 和 使用 OpenAI SDK。
选好模型,核对费用再接入
查看当前模型的价格与参数,用自己的输入、输出和缓存用量估算成本;遇到报错时按错误码排查。