跳转到主要内容
文档目录

接口格式

Claude 用 Anthropic 原生,GPT 用 Chat Completions / Responses,其他模型用 Chat Completions。

本站提供三种接口格式,用同一把密钥、同一份余额。每个系列的模型只能使用它自己的原生格式,不做跨格式调用(例如不能用 Chat Completions 调 Claude)。

格式路径接入地址鉴权方式
Anthropic 原生POST /v1/messageshttps://tokenwayapi.com(不带 /v1)x-api-key 请求头
OpenAI Chat CompletionsPOST /v1/chat/completionshttps://tokenwayapi.com/v1Authorization: Bearer
OpenAI ResponsesPOST /v1/responseshttps://tokenwayapi.com/v1Authorization: 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 模型。

共同点

  • 都支持流式输出(stream: true)。
  • 请求里的 model 必须是 模型定价 页列出的名字。
  • 计费方式与接口格式无关,见 计费与定价。

各格式的示例见 用 curl 测试 和 使用 OpenAI SDK。

选好模型,核对费用再接入

查看当前模型的价格与参数,用自己的输入、输出和缓存用量估算成本;遇到报错时按错误码排查。