RuAPI 能做到什么
- Claude 走原生 Anthropic 接口:和直连 Anthropic 一样。发到
https://www.ruapi.ai/v1/messages的请求,缓存标记cache_control原样转给 Claude,包括ttl。Claude Code、Anthropic SDK,以及选了 Anthropic 提供商的智能体,不用额外设置就有缓存。 - Claude 走 OpenAI 兼容格式:也能缓存。消息内容块上的
cache_control标记,RuAPI 会转给 Claude;请求最外层的一个标记(自动缓存)也能识别。写法和 OpenRouter 一样。Anthropic 官方自己的 OpenAI 兼容接口不支持缓存。 - GPT 和 DeepSeek:自动缓存。请求开头重复时自动命中缓存,什么都不用设置。
- 用量清楚可查。API 返回里写明有多少 token 从缓存读取、多少写入缓存,控制台里每条请求也能看到。
- 不用 VPN,不用境外银行卡。RuAPI 在俄罗斯可以直接访问,余额用 USDT 充值。
价格
各模型的准确价格见价格页。写入缓存比普通输入稍贵,所以同样的上下文只要在缓存有效期内发第二次,就开始省钱了。每命中一次,缓存有效期都会再延长 5 分钟(或 1 小时)。
Claude:怎么开启缓存
先看用的是哪种格式
同一把 RuAPI 密钥可以用两种格式调 Claude:Anthropic 原生格式和 OpenAI 兼容格式。缓存怎么开,要看你用的是哪一种。不确定的话,下面任选一处看:
Claude Code 用的一直是 Anthropic 原生格式,会自己打缓存标记,不用查。用 OpenAI 兼容格式时,只有请求里带了
cache_control 标记才会缓存。两种格式的完整区别见OpenAI 格式还是 Anthropic 格式。
Claude Code 和编程智能体
自己写的程序:Anthropic SDK
把cache_control 标记打在请求中不变部分的最后一个块上,比如很长的系统提示。标记之前的内容都会进缓存。
"cache_control": {"type": "ephemeral", "ttl": "1h"}。
自己写的程序:OpenAI SDK
OpenAI 兼容格式里,标记打在content 的某个块上,所以带标记的消息要把内容写成块的列表,不能写成字符串。
cache_control 标记,Anthropic 把这叫作自动缓存。这时 RuAPI 会像 Anthropic 一样,自己把标记打在最后一条消息的最后一个块上,所以这种写法在我们所有的 Claude 渠道上都能用。每多一条消息,标记就往后挪一条,之前的对话都会进缓存。
一个请求最多打 4 个标记。请求开头太短不会缓存,最短长度因模型而异,例如 Claude Sonnet 5.5 和 Claude Opus 5.5 是 512 个 token。
GPT 和 DeepSeek:自动缓存
- GPT。请求开头至少 1024 个 token 和最近的请求一样时,相同的部分会从缓存读取,不用打标记。
- DeepSeek。缓存一直开着:重复的请求开头按缓存命中价计费。
怎么确认命中了缓存
OpenAI 格式里的
prompt_tokens 已经包含缓存的 token,和 OpenAI 的算法一样。控制台里每条请求也能看到:使用日志 → 打开记录详情。
对比
其他服务的情况来自 Anthropic 和 OpenRouter 的官方文档(2026 年 10 月 15 日核对);OpenRouter 返回 403 来自我们 2026 年 9 月 30 日的检测。
常见问题
为什么没有命中缓存?
为什么没有命中缓存?
- 请求开头变了。标记之前哪怕只差一个字符,比如当前时间、随机 ID,都算新的开头,会重新写入缓存。
- 请求开头太短,达不到这个模型的最短长度。
- 超过 5 分钟没有请求(设了
"ttl": "1h"的是 1 小时)。 - 用 OpenAI 兼容格式调 Claude,但没打
cache_control标记。
Claude 扣费很快、余额掉得快,要查什么?
Claude 扣费很快、余额掉得快,要查什么?
多半是缓存没有生效,重复的上下文每次都按全价计费。
- 先看用的是哪种格式:在控制台 使用日志 里打开一条 Claude 的记录,看「请求路径」。是
/v1/messages的,是 Anthropic 原生格式,缓存和直连 Anthropic 一样(Claude Code 会自己打标记),没命中的原因看上一条。是/v1/chat/completions的,是 OpenAI 兼容格式,接着看下面几步。其他判断办法见本页「先看用的是哪种格式」。 - 看缓存有没有生效:记录详情里有「缓存 Tokens」这一行,就是命中了;重复的请求一直没有这一行,就是没生效。自己写的程序也可以看 API 返回里的
usage.prompt_tokens_details.cached_tokens。 - 看客户端有没有打
cache_control标记:没有标记,Claude 什么都不缓存。很多智能体在 OpenAI Compatible 模式下不打标记,在智能体里改选 Anthropic 提供商就行。自己写的程序,在请求最外层打一个cache_control标记就够了。 - 如果用的是别家网关,查一下它的文档:OpenAI 兼容格式下支不支持 Claude 缓存。不是每家都支持:Anthropic 官方自己的 OpenAI 兼容接口就不支持缓存;再比如 APIYI 的文档写明,Claude 的缓存折扣只在原生 Anthropic 格式下才有(2026 年 10 月 15 日核对)。在 RuAPI,两种格式下 Claude 都能缓存。
缓存要额外收费吗?
缓存要额外收费吗?
写入缓存按普通输入价的 1.25 倍收费(1 小时缓存是 2 倍),但之后每次读取都至少便宜 10 倍。同样的上下文只要发两次以上,就已经省钱了。
要在 RuAPI 控制台里开什么吗?
要在 RuAPI 控制台里开什么吗?
不用。任何密钥都能用缓存:Claude 只要有
cache_control 标记(Claude Code 会自己打),GPT 和 DeepSeek 自动缓存。接下来
- Claude Code:接好就有缓存,不用额外设置。
- 价格:缓存怎么影响最终费用。
- DeepSeek 还是 Claude:一天的活儿到底花多少钱:带缓存的真实账单拆解。
- Claude Code 和 Cline 怎么省钱:哪些操作会让缓存失效,怎么让上下文保持精简。