Lovely Routerドキュメント
キーを取得
モデル API

モデルと料金

GET /v1/models で利用可能なモデルとトークンあたりの価格を一覧し、各呼び出しの請求額がどのように計算されるかを正確に確認します。

モデルはトークン単位で課金され、価格は 100 万トークンあたりの米ドルで表示されます。各呼び出しは、モデルがレスポンスで報告したトークン数に基づいて課金され、その金額は数秒以内にプリペイド残高から差し引かれます。

モデルを一覧する#

GET /v1/models は、今すぐ呼び出せるすべてのモデルを、コンテキストサイズ、価格、そのモデルを提供するチャネルグループとともに返します。API キーは不要で、OpenAI SDK と Anthropic SDK のどちらの client.models.list() でも使えます。

curl https://lovelyrouter.com/v1/models

レスポンスの抜粋:

Response
{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-5.5",
      "object": "model",
      "type": "model",
      "display_name": "Claude Sonnet 5.5",
      "created": 1700000000,
      "created_at": "2025-01-01T00:00:00Z",
      "owned_by": "Anthropic",
      "context_length": 1000000,
      "pricing": {
        "input": 2,
        "output": 10,
        "cache_read": 0.1,
        "cache_write": 2.5,
        "unit": "USD per 1M tokens"
      },
      "groups": ["claude-value"]
    },
    {
      "id": "gpt-6.1-sol",
      "object": "model",
      "type": "model",
      "display_name": "GPT-6.1 Sol",
      "created": 1700000000,
      "created_at": "2025-01-01T00:00:00Z",
      "owned_by": "OpenAI",
      "context_length": 1050000,
      "pricing": {
        "input": 2,
        "output": 10,
        "cache_read": 0.1,
        "cache_write": null,
        "unit": "USD per 1M tokens"
      },
      "groups": ["gpt-value"]
    }
  ],
  "has_more": false,
  "first_id": "claude-fable-5.1",
  "last_id": "gpt-5.6-luna"
}
フィールド意味
id送信するモデル ID。他の表記でも解決されます。モデル ID を参照してください。
owned_byベンダー:Anthropic、OpenAI、Google のいずれか。
context_lengthコンテキストウィンドウの最大サイズ(トークン数)。
pricing.inputキャッシュされない入力トークンの価格。
pricing.output出力トークンの価格。推論トークンと思考トークンを含みます。
pricing.cache_readプロンプトキャッシュから提供される入力トークンの価格。
pricing.cache_writeプロンプトキャッシュに書き込まれる入力トークンの価格。null の場合、キャッシュ書き込みは入力の価格で課金されます。
pricing.unit常に USD per 1M tokens。
groupsそのモデルを提供するチャネルグループ。
created、created_atSDK との互換性のために含まれる固定のプレースホルダー値。

価格はすべて、チャネルグループの倍率を適用する前の定価です。GET /v1beta/models は同じモデルを Gemini の形式で返します(価格は含まれません)。

呼び出しの課金方法#

各呼び出しの使用量は 4 種類のトークンに分けられ、種類ごとにそれぞれの価格で課金されます。

トークンの種類Anthropic の usage フィールドOpenAI の usage フィールドGemini の usage フィールド
キャッシュされない入力input_tokensprompt_tokens から cached_tokens を引いた数promptTokenCount から cachedContentTokenCount を引いた数
キャッシュ読み取りcache_read_input_tokensprompt_tokens_details.cached_tokenscachedContentTokenCount
キャッシュ書き込みcache_creation_input_tokens報告なし報告なし
出力output_tokens(思考を含む)completion_tokens(推論を含む)candidatesTokenCount + thoughtsTokenCount

請求額は次のとおりです。

Text
charge = ( uncached_input × input_price
         + cache_read     × cache_read_price
         + cache_write    × cache_write_price
         + output         × output_price ) ÷ 1,000,000 × multiplier

倍率(multiplier)は、呼び出しを処理したチャネルグループのもので、レスポンスヘッダー x-lovely-group で確認できます。モデル自体が倍率を持つこともあり、その場合はグループの倍率の代わりにモデルの倍率が使われます。現在モデルを提供しているグループはすべて ×1.00 で課金します。そのため、表示価格がそのままお支払い額になります。請求額は $0.000001 単位で切り上げられます。

例として、claude-sonnet-5.5 を使ったエージェントセッションの 1 ターンを見てみます。

トークンの種類トークン数100 万トークンあたりの価格料金
キャッシュされない入力1,200$2.00$0.002400
キャッシュ読み取り30,000$0.10$0.003000
キャッシュ書き込み2,000$2.50$0.005000
出力800$10.00$0.008000
合計$0.018400

キャッシュがなければ、同じ 33,200 入力トークンの料金は $0.066400 になっていました。キャッシュヒットを高く保つ方法はプロンプトキャッシュを参照してください。

画像モデル#

画像モデル(gpt-image-*)はトークン単位ではなく 1 枚単位で課金されます。GET /v1/models では、これらのモデルの pricing はトークン料金の代わりに per_image(1 枚あたりの米ドル)になります。画像の料金を参照してください。

課金されないもの#

  • モデルに届く前に拒否されたリクエスト:無効なキー、許可されていないモデル、残高不足、レート制限、不正な JSON。
  • すべてのチャネルで失敗したリクエストと、別のチャネルで再試行された失敗済みの試行。お支払いは応答した試行の分だけです。
  • POST /v1/messages/count_tokens と Gemini の :countTokens。
  • モデルの一覧取得。

キャンセル・中断されたストリーム#

ストリームを途中で閉じた場合は、その時点までに生成されたトークン分を支払います。入力には、ストリームが報告したトークン数を使います。何も報告されていなかった場合は、リクエストの約 4 文字を 1 トークンとして見積もります。出力は、それまでに報告されたトークン数と、送信済みのテキストを約 4 文字 1 トークンとして見積もった値の、大きいほうになります。

モデルが応答しなくなったためにゲートウェイが打ち切ったストリームも、同じ方法で、送信済みの分が課金されます。ストリーミングを参照してください。

請求額を確認する場所#

すべての呼び出しは、トークン数と請求額とともにログに表示されます。マーケットプレイスでは、倍率を適用済みのチャネルグループごとの各モデルの価格と、リアルタイムの可用性を確認できます。残高とチャージについてはクレジットと請求、使用量レポートについては使用量とログを参照してください。

リアルタイムの価格表#

モデルコンテキスト入力出力キャッシュ読み取りキャッシュ書き込み

GET /v1/models の最新データ · 100 万トークンあたりの USD