/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 日核对)。
怎么选
编程工具
其他工具(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 一个问题,并让它返回思考内容。怎么知道自己用的是哪种格式
在控制台 使用日志 里打开一条 Claude 的记录,看「请求路径」:/v1/chat/completions 是 OpenAI 兼容格式,/v1/messages 是 Anthropic 原生格式。其他判断办法见提示缓存页的「先看用的是哪种格式」。
常见问题
两种格式价格一样吗?
两种格式价格一样吗?
一样。RuAPI 按模型计费,和用哪种格式无关。同一把密钥两种格式都能用,不用另建密钥。
用 OpenAI 兼容格式调 Claude,余额为什么掉得快?
用 OpenAI 兼容格式调 Claude,余额为什么掉得快?
多半是缓存没有生效,重复的上下文每次都按全价计费。在工具里改选 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 可能直接回答,这时没有思考内容是正常的。指定调用某个工具,为什么报 400?
指定调用某个工具,为什么报 400?
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 日核对)。在别家网关用 OpenAI 格式,Claude 为什么没有缓存?
在别家网关用 OpenAI 格式,Claude 为什么没有缓存?
不是每家都支持:Anthropic 官方自己的 OpenAI 兼容接口就不支持缓存,也有网关在文档里写明,只有原生 Anthropic 格式才有缓存折扣。在 RuAPI,两种格式下 Claude 都能缓存。
接下来
- 提示缓存:两种格式下 Claude 的缓存怎么开,怎么确认命中了缓存。
- Claude API:各档模型有什么区别,该选哪个。
- Claude Code:把 Claude Code 接到 RuAPI。
- 函数调用:工具调用的完整示例。