Claude API：
一个预付费密钥调用全部 Claude 模型

1. 创建密钥

   注册并充值（最低 $5），然后在 API 密钥页面创建密钥。你可以为密钥设置消费上限、模型允许列表，或固定一个渠道组。

2. 把 SDK 指向 Lovely Router

   把 base URL 设为 https://lovelyrouter.com。SDK 也会从环境变量读取 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY，所以创建默认客户端的代码无需任何改动。

3. 发送 Messages 请求

   POST /v1/messages 接受 Anthropic 文档中定义的请求体。除模型 ID 外，请求原样到达模型，响应也逐字节原样返回。

   cURLPythonNode.js

   Shell

   curl https://lovelyrouter.com/v1/messages \
     -H "x-api-key: $LOVELY_API_KEY" \
     -H "anthropic-version: 2023-06-01" \
     -H "content-type: application/json" \
     -d '{
       "model": "claude-sonnet-5.5",
       "max_tokens": 1024,
       "messages": [{"role": "user", "content": "Explain HTTP caching in two sentences."}]
     }'

密钥既可以放在 Anthropic SDK 发送的 x-api-key 中，也可以放在 Authorization: Bearer 中。anthropic-version 和 anthropic-beta 会按你发送的原样转发。

以上为实时价格，单位为美元/百万 token，与无需密钥即可调用的 GET /v1/models 返回的数字一致。其他工具使用的写法会解析到同一个模型：claude-sonnet-5-5、anthropic/claude-sonnet-5.5，以及 claude-haiku-4-5-20251001 这类带日期的 ID。模型广场显示每个模型的实时可用性，状态页按小时显示每个渠道组的可用性。

不提供 Message Batches、Files 以及查询单个模型的端点。错误保持 Anthropic 的格式。

提示缓存存在于写入它的渠道上。如果一个对话的每一轮都落到不同的渠道，每一轮都要重新付费写入缓存。Lovely Router 会识别同一对话的各轮请求，并把它们送回持有缓存的渠道。

你无需做任何事：指纹由系统提示词和第一条用户消息组成，对话变长时它们保持不变。如果请求带有 Claude Code 的 x-claude-code-session-id 请求头、metadata.user_id 或 x-session-id 请求头，则优先使用它们。对话活跃期间，这种绑定最长保持一小时。如果绑定的渠道繁忙，该轮请求会短暂等待，而不是写入新的缓存；如果渠道失败，绑定会随该轮请求一起迁移。提示缓存介绍了如何在日志中查看缓存命中情况。

Claude Code 使用的就是 Messages API，所以只需要 base URL 和你的密钥：

export ANTHROPIC_BASE_URL=https://lovelyrouter.com
export ANTHROPIC_AUTH_TOKEN=$LOVELY_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5.5
claude

如需在多个会话间保留这些设置，把它们写到 ~/.claude/settings.json 的 env 下，并设置 ANTHROPIC_DEFAULT_HAIKU_MODEL 用于快速的后台任务。每个会话都会留在持有其缓存的渠道上。完整配置见在你的工具中使用；AI 编程智能体介绍了如何用同一份余额运行 Claude Code、Codex CLI 和 Gemini CLI。

Claude 按 token 计费：未缓存输入、输出（含思考）、缓存读取和缓存写入，各自按模型的每百万 token 价格乘以渠道组的倍率计算。目前所有渠道组都按官方标价计费，因此每个 Claude 模型的价格与 Anthropic 公布的一致，缓存读取和写入也不例外。费用根据响应中的 usage 计算，并在几秒内从你的预付费余额中扣除。

没有订阅费，也没有月费。在到达模型之前就被拒绝的请求不收费；网关在另一个渠道上重试失败的调用时，你只为最终给出响应的那次尝试付费。提前关闭的流只为截至当时已生成的内容付费。价格页在一页中列出了所有产品。