· reAPI Team
OpenRouterの空の応答に料金?まず使用量の記録を確認
OpenRouterの空の応答には、課金対象の推論やクライアントの障害が隠れていることがあります。終了理由、使用量、Zero Completion Insurance、補助料金を確認しましょう。

回答は空白なのに、usage.cost はゼロではありません。料金に異議を申し立てたり、プロンプトを再送信したりする前に、そのレスポンスの残りの部分を確認してください。content フィールドが空でも、モデルがトークンを生成しなかったのか、推論に予算を使ったのか、インターフェースに表示されなかった内容を返したのかは分かりません。
この違いはOpenRouterでは重要です。Zero Completion Insuranceは特定の失敗した生成を対象とする一方、推論は目に見える回答がなくても課金される場合があります。どちらも空のチャット吹き出しになることがあります。終了理由と使用量の記録を見れば区別できます。[1][2]
見えない回答がトークン数に表れている場合があります
以下はChat Completionsレスポンスの例示的な抜粋です。数値は架空のもので、リクエストは実行しておらず、この説明に関係のないフィールドは省略しています。推論が出力上限を消費するという、文書に記載されたパターンを示しています。[2]
{
"choices": [
{
"message": { "content": "" },
"finish_reason": "length"
}
],
"usage": {
"completion_tokens": 1200,
"completion_tokens_details": {
"reasoning_tokens": 1200
}
}
}3つの値を合わせて読み取ってください。content に回答はありません。length は生成が出力上限に達したことを示します。completion数は1,200で、推論の詳細が1,200すべてを占めています。したがって、この例の可視出力数は1,200引く1,200で、ゼロです。見えるテキストがゼロでも、モデル出力がゼロとは限りません。
ほとんどのプロバイダーでは、推論と可視出力がリクエストの出力予算を共有します。OpenRouterは推論を課金対象の出力として数えます。[2] そのため、読みたかった部分に到達する前に、リクエストが上限を使い切ることがあります。アプリケーションにとって望ましくない結果ですが、保険ポリシーに記載されたゼロ補完の条件とは異なります。
この例では意図的に金額を省いています。適用されるモデルとレートが分からなければ、トークン数だけでは価格は決まりません。この架空の例に実在モデルの料金を当てはめず、レスポンスまたは対応する生成記録で実際の usage.cost を確認してください。
推論を非表示にしても、トークンは節約されません。Chat Completionsでは、reasoning.exclude: true を指定すると返される推論は抑制されますが、処理とその課金はそのままです。Responses APIはこの除外設定を無視します。[2] 可視の回答がなく推論も非表示なら、使用量の記録に処理の実行が示されていても、インターフェースは完全に空白になることがあります。
リクエストを変更せずに再送する前に、選択したモデルがサポートする推論制御を確認してください。サポートされる範囲で推論強度を下げるか、適切な推論予算を設定すれば、回答のための余地が残る場合があります。出力上限全体を増やすと、より多くの処理が可能になり、費用も増える可能性があります。タスクに合わせて変更を選び、次の結果を確認してください。どちらの設定も、有用な文章が必ず得られることを保証するものではありません。
別の終了理由なら、課金についての問いも変わります
今度は別の記録を考えてみましょう。completionトークンがゼロで、終了理由が空白またはnullです。OpenRouterはこの組み合わせを保護対象として挙げています。また、errorという終了理由も対象条件として挙げています。対象となるリクエストでは、prompt、completion、reasoningのトークン料金がゼロになり、この保護は自動的に適用されます。[1]
これらの条件をそのまま保ってください。「アプリに何も表示されなかった」は、より広い意味です。通常のstop理由、ツール呼び出し、構造化された結果、クライアント側の解析失敗については、完全なペイロードを確認する必要があります。いずれも、終了理由が空白でトークン数がゼロだったと黙って分類し直してはいけません。
請求明細にはもう一つ区別があります。保護対象の生成でも、検索、ファイル解析、PDF OCR、ウェブ取得など、すでに実行された補助処理に料金が発生する場合があります。OpenRouterのポリシーでは、これらのサービスは別に扱われ、一部の失敗ケースではそれらの料金も免除されると説明されています。[1] ツール操作を試みたことは、料金が発生した証拠にはなりません。実際の内訳を確認してください。
たとえば、ドキュメントのリクエストで解析が完了した後、モデルエラーで終了した場合を想像してください。モデルのトークン料金はゼロで解析料金が記録されているケースと、保護対象のモデルトークンに料金が記録されているケースとでは、確認すべき問いが異なります。これはポリシーの境界を説明するものであり、あなたのドキュメントリクエストにどちらかの料金が発生したという報告ではありません。
サポートに連絡する前に、異議のある明細項目を特定してください。トークン料金が対象となる終了理由と矛盾する場合は、そのフィールドを一緒に提示してください。解析料金であれば、記録が示す解析処理と適用ルールを調べてください。合計額のスクリーンショットだけでは、この二つを区別できません。
BYOK(自分のAPIキーを使用)の利用では、もう一つのアカウントも確認する必要があります。OpenRouterによると、BYOKリクエストは推論プロバイダーが直接請求します。[3] OpenRouterで金額がゼロまたは調整済みでも、それだけでは外部プロバイダーが独自の料金を取り消したとは言えません。そのリクエストを照合するときは、プロバイダーの請求書とOpenRouterの記録を分けてください。
実際に呼び出したAPIのフィールドを確認する
Chat Completionsを前提に構築されたクライアントは、読み取るフィールド名を変更せずResponsesに切り替えると、使用量を取りこぼしたように見えることがあります。同じ会計上の項目でも、OpenRouterのドキュメントでは異なるフィールド名が使われています。[4]
| 確認したい項目 | Chat Completions | Responses |
|---|---|---|
| 入力数 | usage.prompt_tokens | usage.input_tokens |
| 出力数 | usage.completion_tokens | usage.output_tokens |
| 推論数 | usage.completion_tokens_details.reasoning_tokens | usage.output_tokens_details.reasoning_tokens |
| アカウント料金 | usage.cost | usage.cost |
Responsesで出力予算の問題が起きた場合は、status: "incomplete" と incomplete_details.reason: "max_output_tokens" を確認してください。レスポンスには推論が含まれていても、出力にメッセージ項目がない場合があります。[2] Chat Completionsの message.content フィールドだけを探すと、実際に受信した構造を見落とします。
存在しない値は不明のままにしてください。推論の詳細が欠けている場合、ゼロを挿入して、すべての出力トークンが可視だったと結論づけないでください。同様に、解析後のオブジェクトに usage.cost がなければ、パーサーがそれを破棄した可能性もあります。サービスが値を省略したと判断する前に、生のレスポンスと比較してください。
有用な比較方法は、新たな生成を送信せず、保存済みのレスポンスを同じ表示コードに通すことです。このローカルなデバッグでは、まず返されたオブジェクトを確認し、次にパーサーが選んだ値を確認し、最後にインターフェースへ渡された値を確認してください。最初のオブジェクトにテキストがあるのに二つ目で消えていれば、クライアント側で情報が失われた箇所を特定できています。元の記録が上記の推論予算パターンだけを含む場合、表示コンポーネントを変えても、生成されなかった回答を補うことはできません。表示を修正しても料金の証拠が消えないよう、元の記録は変更せずに保管してください。
ローカルで計算した推定額は、報告された料金と分けてください。アプリケーションは、トークン数と保存済み価格表から表示用の値を計算する場合があります。その数字は役立つことがありますが、リクエストで報告された費用と置き換えられるものではありません。古い推定額で返されたゼロを上書きしてはならず、推定額がないことを無料利用として記録してもいけません。
現在のドキュメントによると、完全な使用量は自動で返されます。以前のChat Completionsの usage.include と stream_options.include_usage スイッチは非推奨で、効果もありません。[4] これらを追加しても、クライアントのパーサーは修復されず、届かなかったイベントも復元できません。
記録が届く前にストリームが終了した場合
ストリームの切断は別の欠落を生みます。アプリケーションが最終的な使用量イベントを受信できない場合があります。OpenRouterによると、ストリーミングと非ストリーミングのリクエストでは、同じトークン料金が適用されます。[3] ストリーミングが変えるのは配信方法であり、欠落した会計データの意味ではありません。
生成IDは届いた時点ですぐに保存してください。Responsesのストリームでは、使用量は終端のcompletedまたはincompleteイベントに現れます。その終端イベントがなければ、クライアントはイベントがないことから料金がゼロだと推測できません。[4] 成功または無料の完了を合成するのではなく、実際に受信した最後のイベントを保持してください。
HTTP 200 だけでも不十分です。レスポンスヘッダーが送信された後でも、レスポンス本文やストリームにエラーが現れる場合があります。OpenRouterのドキュメントでは、その状況におけるエラー終了理由が説明されています。[5] HTTPロガーに保存されたステータスだけでなく、イベントの内容を確認してください。
保存したIDで生成メタデータを取得し、Activityと比較してください。ドキュメントに記載された照会では、終了理由、トークン情報、合計費用と、生成を識別する詳細情報が得られます。[6] IDがクライアントに届かなかった場合は、サポート向けにタイムスタンプ、リクエストしたモデル、サニタイズ済みのリクエストコンテキストを保持してください。トレースに記録がなく、費用は未解決のままです。
ストリームを拒否したり失ったりするコーディングクライアントについては、ストリーム切断ガイドで配信の問題を別途説明しています。そのクライアント動作を調査する間も、課金の証拠を保持してください。
ターン全体を再実行する前に、それ以前の手順を確認する
ツールを使う会話では、最初のモデル呼び出しが成功し、ツールの処理も完了した後、最終説明だけが失敗することがあります。仮の例として、ファイルは正常に更新されたものの、モデルの要約がインターフェースに届かなかったとします。最後の吹き出しが空でも、ファイルの変更は取り消されず、そのターンのすべてのリクエストが失敗したことにもなりません。
各生成IDを、それぞれの結果と料金に関連付けてください。そのツールを要求したモデル呼び出しのそばに、ツールの結果を記録してください。ワークフローを再実行する前に、その操作がすでに行われたか確認しましょう。ターン全体を繰り返すと、新しい処理が発生する一方で、元の課金に関する問いへの回答が難しくなる場合があります。
リクエスト内のプロバイダーのフォールバックと、アプリケーションが新たに送信するリクエストも区別してください。OpenRouterの料金案内によると、エラーになった試行ではモデルのトークン料金は請求されず、完了した補助処理は別に扱われます。[3] 新たなクライアントリクエストには独自の記録が必要です。前の試行に適用された保護は、その結果を説明するものではありません。
クレジット購入手数料は、この比較に含めないでください。StandardとBusinessのアカウントでは、手動購入または自動トップアップでクレジットを購入し、その残高からリクエストの費用が差し引かれます。OpenRouterによると、推論にはサービス提供プロバイダーの表示価格が適用され、クレジット購入にはプラットフォーム手数料がかかります。[3] したがって、そのルートがあなたのワークロードで費用を節約できるかどうかを判断するには、すべてのリクエストが割引されると想定するのではなく、適用されるモデル価格と入金手数料を確認する必要があります。OpenRouterの料金ガイドでは、より広い比較を扱っています。カードへの請求額は、1回の生成に対するモデルのトークン料金ではありません。この件で確認すべき問いは明確です。どの生成、終了理由、明細項目が食い違っていますか。記録同士は一致しているのに回答が表示されなかった場合は、その記録が示す出力予算、レスポンスパーサー、またはストリーム処理を引き続き調べてください。
どのゲートウェイでも同じ確認を
出力枠を使い切るこのパターンは、特定のルーターだけのものではありません。reAPI の GPT-6 Sol では推論トークンが出力として課金され、max_completion_tokens は推論と表示テキストの合計を制限します。そのため、回答の長さだけを見積もった枠では、テキストが現れる前に使い切ることがあります。ストリーミングでは、usage は [DONE] の直前の最後のデータチャンクに含まれます。[7]
プロバイダーを比較する際は、保存しておいた同じプロンプトを同じ出力枠で送信し、表示テキストだけでなく、各レスポンスの終了理由と使用量のフィールドを確認してください。利用可能なモデルと現在の料金はモデル一覧にあります。
参考資料
- OpenRouter、Zero Completion Insurance:対象条件、トークンの補償範囲、補助サービスの例外。2026年11月15日閲覧。
- OpenRouter、推論トークン:共有出力予算、不完全なレスポンス、推論の除外。2026年11月15日閲覧。
- OpenRouter、料金:失敗した試行、ストリーミング、BYOK課金に関するFAQ。2026年11月15日閲覧。
- OpenRouter、使用量の記録:APIごとのフィールド、自動的に返される使用量情報、生成IDの照会。2026年11月15日閲覧。
- OpenRouter、エラーとデバッグ:レスポンス本文とストリーミングにおけるエラーの意味。2026年11月15日閲覧。
- OpenRouter、生成リクエストと使用量メタデータの取得。2026年11月15日閲覧。完全なソースURLと公開スナップショットは研究アーカイブに保存されています。
- reAPI。*GPT-6 Sol API リファレンス。*2026年11月17日確認。GPT-6 Sol。