自分のコードや Claude Code から Claude を呼び出し、トークン単位で支払いたい。ベンダーごとにアカウントや請求書を分けるのは避けたい。Lovely Router は Anthropic Messages API を Anthropic の定義どおりに提供しているため、Claude API の使い方はそのままで、公式 SDK と Claude Code はベース URL とキーを変えるだけで動きます。同じキーで GPT や Gemini、データツール、ブラウザエージェントも呼び出せます。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Integrate models from Lovely Router into this project through the native Anthropic Messages API. - Docs (read first): https://lovelyrouter.com/docs/models/anthropic.md - Use the official Anthropic SDK and only change the base URL to https://lovelyrouter.com (or set ANTHROPIC_BASE_URL=https://lovelyrouter.com). Endpoints: POST https://lovelyrouter.com/v1/messages and /v1/messages/count_tokens, unchanged from Anthropic, so Anthropic's docs are the reference for every parameter. `Authorization: Bearer` works too. - GET https://lovelyrouter.com/v1/models lists every model id with its price; pick one there, do not guess ids. - Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `x-api-key: $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys. - Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large. - Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt. My task: <describe what you want to build or get>
仕組み
キーを作成する
SDK の接続先を Lovely Router にする
ベース URL を
https://lovelyrouter.comに設定します。SDK は環境変数のANTHROPIC_BASE_URLとANTHROPIC_API_KEYも読み取るため、既定の設定でクライアントを作成しているコードは変更不要です。Messages リクエストを送る
POST /v1/messagesは、Anthropic のドキュメントにあるボディをそのまま受け付けます。モデル ID 以外は変更されずにモデルへ届き、レスポンスも 1 バイトも変えずに返されます。Shellcurl 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 は送ったとおりに転送されます。
Claude API の料金(リアルタイム)
| モデル | コンテキスト | 入力 | 出力 | キャッシュ読み取り |
|---|---|---|---|---|
| Claude Fable 5.1 claude-fable-5.1 | 1M | $10.00 | $50.00 | $0.25 |
| Claude Opus 5.5 claude-opus-5.5 | 1M | $4.00 | $20.00 | $0.20 |
| Claude Sonnet 5.5 claude-sonnet-5.5 | 1M | $2.00 | $10.00 | $0.10 |
| Claude Haiku 5.5 claude-haiku-5.5 | 1M | $0.10 | $0.50 | $0.01 |
| Claude Fable 5 claude-fable-5 | 1M | $10.00 | $50.00 | $1.00 |
| Claude Opus 5 claude-opus-5 | 1M | $5.00 | $25.00 | $0.50 |
| Claude Sonnet 5 claude-sonnet-5 | 1M | $2.00 | $10.00 | $0.20 |
| Claude Opus 4.8 claude-opus-4.8 | 1M | $5.00 | $25.00 | $0.50 |
| Claude Opus 4.7 claude-opus-4.7 | 1M | $5.00 | $25.00 | $0.50 |
| Claude Opus 4.6 claude-opus-4.6 | 1M | $5.00 | $25.00 | $0.50 |
| Claude Sonnet 4.6 claude-sonnet-4.6 | 1M | $3.00 | $15.00 | $0.30 |
| Claude Opus 4.5 claude-opus-4.5 | 200K | $5.00 | $25.00 | $0.50 |
| Claude Sonnet 4.5 claude-sonnet-4.5 | 1M | $3.00 | $15.00 | $0.30 |
| Claude Haiku 4.5 claude-haiku-4.5 | 200K | $1.00 | $5.00 | $0.10 |
100 万トークンあたりの米ドル価格(カタログからリアルタイム表示)。
100 万トークンあたりの米ドル建てのリアルタイム価格で、キーなしで呼び出せる GET /v1/models が返す値と同じです。他のツールで使われる表記も同じモデルとして扱われます。claude-sonnet-5-5、anthropic/claude-sonnet-5.5、claude-haiku-4-5-20251001 のような日付付き ID などです。各モデルの現在の提供状況はモデルマーケットプレイスで、チャネルグループごとの 1 時間単位の稼働状況はステータスで確認できます。
Messages API の対応機能
stream: true を指定すると、message_start から message_stop までの標準イベントが返されます。ゲートウェイは最初のトークンが届くまでストリームを保留するため、早い段階で失敗したチャネルは、何かが届く前に別のチャネルに切り替えられます。
thinking と output_config は、Anthropic がそのモデル向けにドキュメントで示しているとおりに送ってください。現行モデルではエフォートレベルを指定するアダプティブ思考、Claude 4.5 以前では固定の budget_tokens を使います。思考トークンは出力として課金されます。
JSON Schema の input_schema を持つツール、tool_choice、strict は変更されずに渡されます。tool_use ブロックと tool_result ブロックも同様です。
変化しないプレフィックスに cache_control でマークを付けます。ブレークポイントは最大 4 つまで設定できます。usage には cache_creation_input_tokens と cache_read_input_tokens が報告され、それぞれの料金で課金されます。
POST /v1/messages/count_tokens は無料で、残高がゼロでも使えます。
Message Batches、Files、モデル取得のエンドポイントは提供していません。エラーは Anthropic の形式のまま返されます。
ロードバランシングでも崩れないプロンプトキャッシュ
プロンプトキャッシュは、それを書き込んだチャネル上に存在します。会話のターンごとに別のチャネルへ振り分けられると、毎ターン、キャッシュの書き込み料金を払い直すことになります。Lovely Router は 1 つの会話に属するターンを識別し、キャッシュを持つチャネルに送り返します。
特別な設定は不要です。フィンガープリントにはシステムプロンプトと最初のユーザーメッセージを使います。どちらも会話が長くなっても変わりません。Claude Code の x-claude-code-session-id ヘッダー、metadata.user_id、x-session-id ヘッダーがある場合は、そちらが優先されます。会話が続いている間、固定は最長 1 時間維持されます。固定先のチャネルが混雑しているときは、新しいキャッシュを書き込む代わりにターンが少しだけ待ちます。チャネルが失敗したときは、固定先がターンとともに移ります。ログでキャッシュヒットを確認する方法はプロンプトキャッシュを参照してください。
Claude Code から使う
Claude Code は Messages API で通信するため、必要なのはベース 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 も設定します。各セッションは、そのキャッシュを持つチャネルにとどまります。セットアップの全手順はお使いのツールで使うに、Claude Code・Codex CLI・Gemini CLI を 1 つの残高で動かす方法は AI コーディングエージェントにまとめています。
レシピ
メンバーごとに、利用上限と Claude の ID の許可リストを設定したキーを 1 つずつ作成します。上限に達したキーのリクエストは実行されず、402 が返ります。
ドキュメントを cache_control 付きの system ブロックに入れ、各質問をユーザーターンとして送ります。キャッシュを書き込むのは最初の呼び出しだけです。
同じボディから max_tokens を除いて count_tokens を呼び出し、input_tokens をコンテキスト長と比べます。
本番用のキーを claude-value に紐付けると、すべての呼び出しとフェイルオーバー時の再試行がこのグループで処理され、課金されます。
GPT は OpenAI API で、Gemini はネイティブ API で、どちらも同じキーで呼び出せます。
支払う料金
Claude はトークン単位で課金されます。キャッシュされない入力、出力(思考を含む)、キャッシュ読み取り、キャッシュ書き込みのそれぞれに、モデルの 100 万トークンあたりの価格とチャネルグループの倍率を掛けた金額がかかります。現在はすべてのグループが定価で課金するため、各 Claude モデルの料金はキャッシュの読み書きも含めて Anthropic の定価どおりです。請求額はレスポンスの usage から計算され、数秒以内にプリペイド残高から差し引かれます。
サブスクリプションや月額料金はありません。モデルに届く前に拒否されたリクエストは無料です。失敗した呼び出しをゲートウェイが別のチャネルで再試行した場合、支払うのは応答した試行の分だけです。途中で閉じたストリームは、それまでに生成された分だけ課金されます。すべてのプロダクトの料金は料金ページにまとめています。
よくある質問
Anthropic SDK のコードを変更する必要はありますか?+
いいえ。ベース URL を https://lovelyrouter.com に設定し、Lovely Router のキーを Claude API キーとして使うだけです。リクエストボディは変更されずに渡されるため、どのパラメーターについても Anthropic のドキュメントがそのまま当てはまります。
Lovely Router 経由でもプロンプトキャッシュは機能しますか?+
はい。cache_control は変更されずにモデルに届き、ゲートウェイは各会話をキャッシュを持つチャネルにとどめます。キャッシュ読み取りとキャッシュ書き込みは、モデルのキャッシュ料金で課金されます。
プリペイドのキーで Claude Code を使えますか?+
はい。ANTHROPIC_BASE_URL を https://lovelyrouter.com に、ANTHROPIC_AUTH_TOKEN をあなたのキーに設定してください。Claude Code のセッションヘッダーによって 1 つのセッションのすべてのターンが同じチャネルにとどまるため、プロンプトキャッシュが有効なまま保たれます。
チャネルが過負荷になったりダウンしたりしたらどうなりますか?+
リクエストは空きが出るまで最大 10 秒待ち、失敗したリクエストは同じグループ内の別のチャネルで再試行されます(最大 3 回まで試行)。すべての試行が失敗した場合は、Anthropic のエラー形式で再試行可能な 429 または 502 が返され、料金は一切かかりません。
どの Claude モデルを呼び出せますか?+
claude-fable-5.1、claude-opus-5.5、claude-sonnet-5.5、claude-haiku-5.5 と、それ以前のバージョンです。現在の一覧は GET /v1/models で価格付きで取得でき、キーは不要です。
すべてのエンドポイントとヘッダーは Anthropic Messages ガイドを、再試行についてはレート制限とフェイルオーバーを参照してください。Claude にライブの Web データを渡すなら MCP サーバーを使えます。