残高とクォータ
RouteAPI はプリペイド方式です。まずアカウントにチャージし、呼び出し時は実際の利用量に応じて残高から課金されます。API キーごとにクォータを個別に設定でき、自動チャージを有効にすれば残高切れによるサービス停止を防げます。
アカウント残高、モデル価格、API キーのクォータ、チャージ金額はすべて米ドル（USD）で計算されます。コンソールではサイト設定に応じて他の通貨に換算して表示される場合がありますが、これは表示上の換算にすぎず、課金と記録は常に米ドル基準です。
アカウント残高
Section titled “アカウント残高”アカウント残高は、すべての API キーで共有される資金プールです。ウォレットページで現在の残高と過去の利用量を確認できます。
- リクエストごとにアカウント残高から課金され、残高がマイナスになることはありません。
- 残高が 1 回のリクエストの見積額を支払うのに不足している場合、リクエストは拒否され、
403とエラーコードinsufficient_user_quotaが返されます。見積りの方法は利用量と請求をご覧ください。 - アカウントに専用の割引がある場合、モデル広場には割引後の価格が表示され、使用ログには「専用料率」と表示され、課金は割引後の価格で計算されます。
API キーのクォータ
Section titled “API キーのクォータ”API キーページでキーを作成または編集する際、キーごとに以下を個別に設定できます:
| 設定 | 説明 |
|---|---|
| クォータ（米ドル） | このキーで消費できる上限金額。無制限にも設定可能 |
| 有効期限 | 期限切れになるとキーは無効になる。デフォルトは無期限 |
| モデル制限 | このキーで呼び出せるモデルを指定 |
| IP ホワイトリスト | 指定した IP からのリクエストのみ受け付ける |
キーのクォータは上限であり、独立したウォレットではありません。1 回のリクエストでキーのクォータとアカウント残高の両方から差し引かれ、どちらかが不足するとリクエストは拒否されます。無制限に設定しても、実際に利用できる金額はアカウント残高によって制限されます。
一般的な使い方として、プロジェクト、環境、メンバーごとにキーを作成してそれぞれにクォータを設定し、1 つのアプリが暴走してアカウント全体の残高を使い果たすのを防ぎます。API キー一覧には、キーごとの使用済みクォータと総クォータが表示されます。
| 状況 | レスポンス |
|---|---|
| キーのクォータを使い切った | 401、キーのクォータが枯渇した旨のメッセージ |
| キーの残りクォータが今回の見積額に不足 | 403、エラーコード pre_consume_token_quota_failed |
| キーが期限切れまたは無効化されている | 401 |
| キーで許可されていないモデルをリクエストした、または送信元 IP がホワイトリストにない | 403 |
ウォレットページで金額と支払い方法を選んでチャージします。最低 1 米ドルです。利用可能な支払い方法は、ウォレットページに表示される内容に準じます。
- 残高は入力した米ドル金額で計上されます。
- Stripe のカード決済では、実際の請求額にチャージ金額の 4% の手数料が含まれ、決済処理費と税金を補填します。支払い前に、実際の請求額がページに表示されます。
自動チャージ
Section titled “自動チャージ”自動チャージを有効にすると、残高が設定したしきい値を下回ったときに、保存済みのカードで固定金額が自動チャージされます。長期間安定して稼働する本番環境に適しています。ウォレットページの「自動チャージ」で設定します。
| 設定 | 説明 | 範囲 |
|---|---|---|
| トリガーしきい値 | 残高がこの金額を下回るとチャージをトリガー | 1,000 米ドル以下、デフォルト 20 米ドル |
| 1 回のチャージ金額 | 自動チャージ 1 回あたりの金額 | 10〜5,000 米ドル、デフォルト 100 米ドル |
| 月間上限 | 1 か月（暦月）内の自動チャージ累計上限。0 は無制限 | 50,000 米ドル以下、かつ 1 回のチャージ金額以上 |
| 支払い方法 | 請求に使用するカード | 最大 3 枚まで保存でき、設定した順序で使用 |
動作:
- リクエストの決済後に残高をチェックし、しきい値を下回っていればチャージを 1 回トリガーします。自動チャージの間隔は最低 10 分です。
- 設定の保存時に残高がすでにしきい値を下回っている場合は、即座にチャージが 1 回トリガーされます。
- デフォルトのカードが明確に拒否された場合（カードの期限切れ、発行会社による拒否など）は、保存済みの次のカードを順に試します。結果が不明な場合（3D セキュア認証が必要など）は、二重請求を避けるためカードを切り替えません。
- すべてのカードが失敗した場合、15 分後、1 時間後、3 時間後、6 時間後に自動で再試行します。それでも失敗すれば再試行を停止し、メールで通知します。ウォレットページにもヒントが表示され、支払い方法を変更した後に「今すぐチャージ」をクリックできます。
- 月間上限に達すると、その月は自動チャージを行いません。
- 自動チャージにも 4% の手数料がかかります。
残高アラート
Section titled “残高アラート”個人設定の通知設定で残高アラートのしきい値を設定でき、残高がしきい値を下回るとメール、Webhook、Bark、Gotify で通知されます。残高切れでリクエストが拒否された場合もメールで通知され、1 日 1 回までです。