跳转到主要内容
调 Claude 有两种格式:Anthropic 原生格式(Messages API,地址是 /v1/messages)和 OpenAI 兼容格式(Chat Completions,地址是 /v1/chat/completions)。在 RuAPI,同一把密钥两种格式都能用,价格也一样;两者的区别在请求的写法和能用的功能上。这一页讲清楚有哪些区别、该选哪个。RuAPI 在俄罗斯不用 VPN 就能直接访问,余额用 USDT 充值。

一句话结论

  • 工具里能选 Anthropic 提供商,或者程序只用 Claude:选 Anthropic 原生格式。 请求的写法和 Anthropic 官方文档一样,缓存也和直连 Anthropic 一样,Claude Code 等工具会自己打缓存标记。Claude Code 只能用这种格式。
  • 工具只支持 OpenAI 格式,或者同一段代码要换着用 Claude、GPT、DeepSeek、Gemini:选 OpenAI 兼容格式。 在 RuAPI,这种格式下缓存、思考和 PDF 也都能用;缓存需要请求里带 cache_control 标记。

两种格式有什么区别

RuAPI 的 OpenAI 兼容格式比 Anthropic 官方的多了什么

Anthropic 自己也提供一个 OpenAI 兼容接口。官方文档写明,它主要用来测试和对比模型,对大多数用途来说不适合长期用在正式产品里,而且很多功能用不了。RuAPI 的 OpenAI 兼容格式由我们自己转换成 Claude 的原生请求,下面这些都能用: Anthropic 一栏来自 Anthropic 官方文档 OpenAI SDK compatibility(2026 年 10 月 19 日核对)。

怎么选

编程工具

Anthropic 原生格式的地址带不带 /v1,要看工具:Claude Code、Cline、Roo Code、OpenClaw 和 Anthropic SDK 不带,Kilo Code、Continue、OpenCode 带。照上表填,填错就连不上。OpenAI 兼容格式的地址一律带 /v1。
其他工具(JetBrains AI Assistant、n8n、Cherry Studio 等)按各自的教程用 OpenAI 兼容格式接,地址是 https://www.ruapi.ai/v1。这样接 Claude 照样能用,只是工具没打缓存标记时不会缓存,长对话会贵一些。

自己写的程序

  • 只用 Claude:用 Anthropic SDK(pip install anthropic),base_url="https://www.ruapi.ai"。功能最全,缓存、思考、PDF 的写法和 Anthropic 官方文档一样。
  • 要换着用不同厂商的模型:用 OpenAI SDK,base_url="https://www.ruapi.ai/v1",换模型只改 model。Claude 要缓存,就在请求里带 cache_control 标记,写法见提示缓存。

同一个请求的两种写法

下面两段代码做的是同一件事:带系统提示问 Claude 一个问题,并让它返回思考内容。
用 curl 发最简单的请求:

怎么知道自己用的是哪种格式

在控制台 使用日志 里打开一条 Claude 的记录,看「请求路径」:/v1/chat/completions 是 OpenAI 兼容格式,/v1/messages 是 Anthropic 原生格式。其他判断办法见提示缓存页的「先看用的是哪种格式」。

常见问题

一样。RuAPI 按模型计费,和用哪种格式无关。同一把密钥两种格式都能用,不用另建密钥。
多半是缓存没有生效,重复的上下文每次都按全价计费。在工具里改选 Anthropic 提供商,或者在请求里带上 cache_control 标记。怎么一步步排查,见提示缓存页的常见问题。
看 finish_reason(OpenAI 兼容格式)或 stop_reason(Anthropic 原生格式):是 length 或 max_tokens,就是到了长度上限。请求里没写 max_tokens 时,RuAPI 按 8192 个 token 补上;要更长的回复,就在请求里写一个更大的 max_tokens。思考用掉的 token 也算在 max_tokens 里。
Claude 5 系列模型(例如 Sonnet 5.5、Opus 5.5、Haiku 5.5)默认会思考,但不返回思考的文字。Anthropic 原生格式里要写 thinking: {"type": "adaptive", "display": "summarized"} 才会返回;OpenAI 兼容格式里带上 reasoning_effort,RuAPI 会替你打开。问题很简单时,Claude 可能直接回答,这时没有思考内容是正常的。
Claude Opus 5.5、Claude Sonnet 5.5、Claude Fable 5.1 不支持强制调用工具:OpenAI 兼容格式里的 tool_choice: "required" 或指定函数名,Anthropic 原生格式里的 {"type": "any"} 或 {"type": "tool"},都会报 400,两种格式一样。改成 auto,并在提示里说清楚什么时候该用这个工具。依据是 Anthropic 官方文档 Thinking(2026 年 10 月 19 日核对)。
不是每家都支持:Anthropic 官方自己的 OpenAI 兼容接口就不支持缓存,也有网关在文档里写明,只有原生 Anthropic 格式才有缓存折扣。在 RuAPI,两种格式下 Claude 都能缓存。

接下来

  • 提示缓存:两种格式下 Claude 的缓存怎么开,怎么确认命中了缓存。
  • Claude API:各档模型有什么区别,该选哪个。
  • Claude Code:把 Claude Code 接到 RuAPI。
  • 函数调用:工具调用的完整示例。