API リファレンス

請求と残高

ウォレットから支払い、呼び出しごとに精算します。トークン課金のモデルは入力・出力 100 万トークンあたりで、画像・動画・タスク型のモデルはリクエストごとに課金されます。失敗したリクエストは自動で返金されます。

#トークン単位の料金

入力トークンと出力トークンは別々に計測されます。モデルごとの全料金は /models のカードに表示され、完了した各リクエストの最終的な実際の消費額はリクエストログに表示されます。

usage.json

{
  "usage": {
    "prompt_tokens": 128,
    "completion_tokens": 402,
    "total_tokens": 530
  }
}

利用枠はリクエスト開始時に事前確保され（max_tokens による最悪ケースの見積もり）、レスポンス完了時にベンダーが報告した使用量に合わせて精算されます — 支払うのは実際の使用分だけです。

画像、動画、TTS などタスク型のモデルは、成功した呼び出しごとに定額で課金されます。解像度や長さによって料金が異なる場合があります — 必ず先にモデルカードを確認してください。

リクエスト単位のモデルは、1 つのモデルに複数のティアを持てます：画像のティアは size と quality、動画のティアは長さと解像度で決まります。ティアは送信時にリクエストパラメーターから決定され、各ティアの料金はモデルカードに記載されています。

ティア別料金

size、quality、duration によって課金ティアが決まります — ティアごとの正確な料金はモデルカードに記載されており、失敗した呼び出しは自動で返金されます。

リクエストが失敗したり、非同期タスクが完了しなかったりした場合、事前課金した利用枠は自動で返却されます。リクエストログには最終的な実際の消費額が表示されるため、失敗した呼び出しが別々の課金と返金のように見えることはありません。

すべての使用量は 1 つのプリペイド式ウォレットから精算されます — 後払いの請求書発行はありません。キーに独自の利用枠の上限がない限り、すべてのキーが同じ残高から支払います。

コンソール → ウォレットからチャージします。利用できる支払い方法（カードやその他のプロバイダー）と最低チャージ額は決済画面に表示されます。引き換えコードも同じ画面で適用でき、即座に反映されます。

残高に有効期限はありません。支払いが成功したのに数分経っても残高が変わらない場合は、支払いの参照番号を添えてサポートチケットを作成してください。

残高がリクエストの事前確保見積額に足りない場合、呼び出しは 402 insufficient_quota ですぐに失敗します — 課金は一切発生しません。チャージしてから再試行してください。すでに進行中の長いストリームが途中で切られることはありません。

コンソール → 使用量では、モデル別・日別のトークン数と支出をキーごとにグラフ表示します — どのプロジェクトやモデルがコストを押し上げているかを最も早く確認できます。

コンソール → リクエストログは、API の支出に関するお客様向けの信頼できる情報源です。各行には日時、モデル、トークン使用量または呼び出し料金、リクエスト ID、最終的な実際の消費額が含まれます。

リクエストログの各行には、リクエストの識別子とタイムスタンプが含まれます。特定の呼び出しについてサポートチケットを作成する際は、その行（日時、モデル、リクエスト ID）を引用してください — サポートが上流での実際の試行を正確に追跡できます。

プロンプトは保存されません

ゲートウェイが保存するのはメタデータ（モデル、トークン数、コスト、タイムスタンプ、リクエスト ID）だけです — プロンプトの内容は保存しません。ただし、デバッグのためにリクエストのログ記録を明示的に有効にした場合は除きます。

まだ解決しませんか？

リクエスト ID かエラーメッセージを送っていただければ、こちらで調査します。