ドキュメント
料金・決済

仮確保と残高の差し引き

Markdown

Ailootの料金処理。リクエスト前に金額を仮確保し、レスポンス後に一度だけ残高から差し引きます。残高がマイナスになることはありません。

概要

  • 仮確保 では、新しいテキストリクエストを送信する前に、合意済みのリクエスト条件に基づき、入力と標準的なレスポンスの見積額をAilootが仮確保します。出力が画像、動画、音声の場合は、結果の料金全額の仮確保を維持します。
  • 残高の差し引き は一度だけです。実際の使用量の参照元:usage。仮確保した金額の未使用分は、すぐに解放されます。
  • 最低限の仮確保に必要な残高もない場合 、リクエストはモデルへ送信されません。分かりやすい説明付きの402エラーが返り、料金は差し引かれません。
完全ガイド

概要

  • 料金 は、入力・出力の1百万トークンあたりのドル建て料金、または単位ごとの料金です(画像一枚、動画の秒数、文字数など)。各モデルの料金の参照先:カタログ。
  • 仮確保 では、新しいテキストリクエストを送信する前に、合意済みのリクエスト条件に基づき、入力と標準的なレスポンスの見積額をAilootが仮確保します。出力が画像、動画、音声の場合は、結果の料金全額の仮確保を維持します。
  • 拒否する代わりに上限を引き下げ では、計算した仮確保額が利用可能な残高やキーの上限に収まらない場合、その上限を実際に守るモデルとメソッドに限り、適用される最低量を下回らない支払い可能な範囲まで出力上限を引き下げられます。対応するモデルは 以下。
  • 残高の差し引き は一度だけです。実際の使用量の参照元:usage。仮確保した金額の未使用分は、すぐに解放されます。
  • レスポンスの料金が仮確保額を超えた場合 、差額は、他の仮確保に使われていない空き残高から差し引かれます。差し引く金額が残高を超えることはなく、残高がマイナスになることもありません。
  • 最低限の仮確保に必要な残高もない場合 、リクエストはモデルへ送信されません。分かりやすい説明付きの402エラーが返り、料金は差し引かれません。
  • 結果を得られなかったエラーは課金されません。接続が切れた場合は、再送する前にダッシュボードの履歴でRequest IDを確認してください。

仮確保額の計算方法

  • 入力 は、リクエストと対応する添付ファイルのサイズを見積もって仮確保します。すでに判明している実際の使用量に基づくものではありません。新しいテキストリクエストでは、リクエスト本体と添付ファイルの種類に応じた見積もりを使います。「バイトあたり4トークン、最低4096トークン」という計算は、旧バージョンで以前に受け入れた仮確保に適用されるもので、新しいテキストリクエストの仮確保を説明するものではありません。添付ファイルをリンクで渡した場合(fileData)、または組み込みツールを有効にした場合、対応するテキストリクエストでは、添付ファイルとツール処理をそれぞれ見積もります。それらがあるだけで、入力ウィンドウ全体の料金を仮確保するわけではありません。以前の仮確保は合意済みの条件を維持し、出力メディアでは結果全体の料金を計算します。
  • 出力 は、新しいテキストリクエストの仮確保において、標準的なレスポンス長と合意済みの条件に基づいて見積もります。要求する上限は max_tokens (max_output_tokens はResponsesの場合)。要求した上限が、そのまま仮確保の計算に使うトークン数になるわけではありません。また、出力長を確実に制限できないモデルでは、実際の出力長を保証しません。初期値4096が適用されるのは対応するルートだけで、具体的な規則はモデルとメソッドによって異なります。
  • 料金 は、新しいテキストリクエストの仮確保について、そのリクエストの条件に応じて、標準または優先モードと、入力の見積もりで到達し得る料金段階を考慮します。選択した条件の範囲では保守的に計算し、flexモードで仮確保額を減らすことはありません。優先リクエストでは、priority、flex、fastを含め、適用可能な最も高いモードを仮確保に使う場合があります。こうした条件なしで以前に受け入れた仮確保は、最高料金による元の計算を維持します。
  • 上限の引き下げ は、計算した仮確保額が収まらず、使用するモデルとメソッドが出力長を制限できる場合に行います。利用可能な資金で、入力の見積額と最低出力量を支払える必要があります。引き下げ後の上限も256トークン未満にはしません(Anthropic形式で推論を使う場合は1025)。モデルには、引き下げ済みの上限を渡します。

計算例

モデル claude-sonnet-5-5:入力は$2、出力は$10/1百万トークン。送信した入力は20 000トークン、モデルのレスポンスは1 200トークンです。

手順計算金額
実際の入力20 000 × $2 / 1 000 000$0.0400
実際のレスポンス1 200 × $10 / 1 000 000$0.0120
差し引かれた金額実際の使用量に基づく一度の差し引き$0.0520

この計算例の実際の料金は$0.0520です。表示されている差し引き額は、合意済みの仮確保額と利用可能な空き残高が、この料金をカバーできる場合のものです。この例では仮確保額自体は計算していません。新しいテキストリクエストでは、入力と標準的なレスポンスの見積もりから別途決まり、実際の料金より大きくも小さくもなり得ます。仮確保の未使用分は解放されます。差し引き額の上限は、以下の式で示します。

実際に差し引く金額 = min(実際の費用の全額, 同意した保留額 + 保留されていない利用可能な残高)。他の未決済の仮確保は保護されるため、合計残高が必ずゼロになるわけではありません。残高がマイナスになることはありません。実際の料金が、合意済みの仮確保額と仮確保されていない空き残高の合計を超えた場合、不足分はAilootの損失となります。利用者の債務にはならず、後から請求されることもありません。

クライアントの切断

接続を閉じる、アプリケーションがタイムアウトする、完成済みのレスポンスを読み取らない、といった操作では、リクエストは自動的に取り消されません。完成したモデルのレスポンスは一度だけ課金されます。Ailootの責任で結果が届かなかった場合は返金されます。接続が切れた場合は、再送する前にダッシュボードの履歴でRequest IDを確認してください。

より多くの残高が必要になる場合

  • 新しいテキストリクエストでは、出力の仮確保額を標準的なレスポンス長に基づいて計算し、指定した max_tokensと使用するモデルの条件を考慮します。これは仮確保額の見積もりであり、実際の出力長やレスポンスの料金を保証するものではありません。
  • 実際の出力長を確実に制限できないモデルでは、仮確保額の見積もりが出力長の制限になるわけではありません。新しいテキストリクエストで、その見積額が最長レスポンスの料金に自動的に置き換わることはありません。以前に受け入れた仮確保は、元の条件を維持します。
  • 入力画像の料金見積もりは、仮確保額に加算されます。
  • エージェント(Claude Code、Codex CLI、Cline)は、各ステップで大きなコンテキストを送信します。一つのステップで数十セントを仮確保する場合があるため、残高には少なくとも数ドルを用意してください。
  • ヒント:適切な値を指定してください:max_tokens 。出力長を制限できるモデルでは、仮確保額を抑えられます。

プロンプトキャッシュ

キャッシュに対応するモデルでは、キャッシュへの書き込みと読み取りに、それぞれ料金が設定されています。通常、読み取りは通常の入力より数倍安くなります。料金はカタログのモデルカードで確認できます。

402エラー

最低限の仮確保に必要な空き残高もない場合、Ailootはリクエストを送信せず、402と次のコードを返します:insufficient_balance。キーの総支出上限に達した場合のコードは api_key_quota_exhaustedです。アカウントに異議申し立て対象の支払いに関する未払いがある場合のコードは payment_disputedです。未払いが解消されるまで、新しいリクエストは停止されます。

402 Payment Required
{
  "error": {
    "code": "insufficient_balance",
    "reason": "insufficient_balance",
    "type": "insufficient_quota",
    "param": null,
    "message": "Your balance is too low to start this request. … Request ID: 5c0e7a1d-….",
    "request_id": "5c0e7a1d-…"
  }
}

支出の確認場所

リクエストと残高の差し引きの履歴は、次のサイトのダッシュボードで確認できます:ailoot.ai。各リクエストのモデル、トークン数、金額が表示されます。

ご不明な点はありますか?Request IDと状況の説明をお送りください。調査をお手伝いします。サポートに問い合わせる