餘額與額度
RouteAPI 採用預付費模式：先為帳戶儲值，呼叫時按實際用量從餘額中扣費。你可以為每個 API 金鑰個別設定額度，也可以開啟自動儲值，避免餘額耗盡導致服務中斷。
帳戶餘額、模型價格、API 金鑰額度與儲值金額都以美元（USD）計價。控制台可能依站點設定把金額換算成其他貨幣顯示，這只是顯示層面的換算，扣費與記帳始終以美元為準。
帳戶餘額是你所有 API 金鑰共用的資金池，在錢包頁面查看目前餘額與歷史用量。
- 每次請求都從帳戶餘額扣費，餘額不會被扣成負數。
- 餘額不足以支付一次請求的預估費用時，請求會被拒絕，返回
403，錯誤碼為insufficient_user_quota。預估方式見用量與計費。 - 如果你的帳戶享有專屬折扣，模型廣場會顯示折扣後的價格，使用日誌會標註「專屬倍率」，扣費按折扣後的價格計算。
API 金鑰額度
Section titled “API 金鑰額度”在 API 金鑰頁面建立或編輯金鑰時，可以為每個金鑰個別設定：
| 設定 | 說明 |
|---|---|
| 額度（美元） | 這個金鑰最多能消費的金額，也可以設為無限額度 |
| 過期時間 | 到期後金鑰失效，預設永不過期 |
| 模型限制 | 只允許這個金鑰呼叫指定的模型 |
| IP 白名單 | 只接受來自指定 IP 的請求 |
金鑰額度是一個上限，不是獨立的錢包。一次請求會同時扣減金鑰額度與帳戶餘額，兩者任一不足，請求都會被拒絕。即使設定了無限額度，實際可用金額也受帳戶餘額限制。
常見用法是為不同專案、環境或成員分別建立金鑰並設定各自的額度，防止單一應用失控耗光整個帳戶的餘額。API 金鑰清單會顯示每個金鑰的已用額度與總額度。
| 情況 | 返回 |
|---|---|
| 金鑰額度已用完 | 401，提示金鑰額度已耗盡 |
| 金鑰剩餘額度不足以支付本次預估費用 | 403，錯誤碼 pre_consume_token_quota_failed |
| 金鑰已過期或已停用 | 401 |
| 請求了金鑰不允許的模型，或來源 IP 不在白名單內 | 403 |
在錢包頁面選擇金額與付款方式完成儲值，最低 1 美元。可用的付款方式以錢包頁面顯示為準。
- 餘額按你填寫的美元金額計入。
- 透過 Stripe 信用卡付款時，實際扣款包含儲值金額 4% 的手續費，用於支應支付處理費與稅費。付款前頁面會顯示實際扣款金額。
開啟自動儲值後，餘額低於你設定的閾值時，系統會用已儲存的信用卡自動儲值一筆固定金額，適合需要長期穩定運作的生產環境。在錢包頁面的「自動儲值」中設定。
| 設定 | 說明 | 範圍 |
|---|---|---|
| 觸發閾值 | 餘額低於這個金額時觸發儲值 | 不超過 1,000 美元，預設 20 美元 |
| 每次儲值金額 | 每次自動儲值的金額 | 10–5,000 美元，預設 100 美元 |
| 每月上限 | 一個自然月內自動儲值的累計上限，0 表示不限 | 不超過 50,000 美元，且不低於每次儲值金額 |
| 付款方式 | 用於扣款的信用卡 | 最多儲存 3 張，按設定順序使用 |
運作方式：
- 每次請求結算後檢查餘額，低於閾值就觸發一次儲值。兩次自動儲值之間至少間隔 10 分鐘。
- 儲存設定時若餘額已低於閾值，會立即觸發一次儲值。
- 預設卡被明確拒絕（如卡已過期、被發卡行拒絕）時，會依序嘗試下一張已儲存的卡。結果不明確時（如需要 3D 驗證）不會換卡，以免重複扣款。
- 所有卡都失敗後，會在 15 分鐘、1 小時、3 小時、6 小時後自動重試。仍然失敗就停止重試，並寄送郵件通知你。錢包頁面也會顯示提示，更換付款方式後可以點選「立即儲值」。
- 達到每月上限後，當月不再自動儲值。
- 自動儲值同樣收取 4% 的手續費。
在個人設定的通知設定中可以設定餘額提醒閾值，餘額低於閾值時透過郵件、Webhook、Bark 或 Gotify 通知你。餘額耗盡導致請求被拒絕時，系統也會寄送郵件提醒，每天最多一次。