預留金額與扣款
MarkdownAiloot 如何計算費用:請求前先保留金額,完成後扣款一次,餘額永遠不會變成負數。
摘要
- 保留金額 —傳送新的文字請求前,Ailoot 會依請求已接受的條件,按輸入與一般回應的估計用量保留金額。影像、影片與音訊的輸出,仍保留結果的完整費用。
- 扣款 —依據此欄位中的實際用量,扣款一次:
usage。剩餘的保留金額會立即退回。 - 若連最低保留金額都不足 —請求不會傳送到模型,您會收到附有易懂文字的 402 錯誤。不會扣款。
完整指南
摘要
- 價格 —以美元計價,按每 1 百萬輸入及輸出 token,或按單位 (影像、影片秒數、字元) 收費。各模型的價格請見目錄。
- 保留金額 —傳送新的文字請求前,Ailoot 會依請求已接受的條件,按輸入與一般回應的估計用量保留金額。影像、影片與音訊的輸出,仍保留結果的完整費用。
- 降低上限,而非拒絕請求 —若計算出的保留金額超過可用餘額或金鑰上限,只有確實遵守上限的特定模型與方法,才能將回應上限降至可支付的程度,且不得低於適用的最低值。支援此方式的模型,請見下方。
- 扣款 —依據此欄位中的實際用量,扣款一次:
usage。剩餘的保留金額會立即退回。 - 若回應費用高於保留金額 —差額會從未被其他保留金額占用的可用餘額中扣除。扣款永遠不會超過您的餘額,餘額不會變成負數。
- 若連最低保留金額都不足 —請求不會傳送到模型,您會收到附有易懂文字的 402 錯誤。不會扣款。
- 未產生結果的失敗不會計費。若連線中斷,請先在控制台歷史紀錄中以 Request ID 查詢請求,再決定是否重新傳送。
如何計算保留金額
- 輸入 會依請求與支援附件的估計大小保留金額,而非依已知的實際用量。新的文字請求會依內容類型,估算請求主體與附件。「每位元組 4 token,但至少 4096 token」的算法,只適用於先前依舊版規則接受的保留金額,不適用於新的文字請求保留金額。若附件透過連結傳入 (
fileData) 或啟用內建工具,支援的文字請求會分別估算附件與工具執行所需的費用;有這些內容本身,不代表必須按整個輸入視窗保留金額。既有的保留金額仍維持當時接受的條件,媒體輸出則仍按完整結果計算。 - 輸出 在計算新的文字請求保留金額時,會依一般回應長度與已接受的條件估算。要求的上限透過以下參數設定:
max_tokens(max_output_tokens用於 Responses)。要求的上限不會自動等於計算保留金額所使用的 token 數;若模型無法可靠限制回應長度,要求的上限也不保證實際回應長度。初始值 4096 只適用於相應路由;具體規則依模型與方法而異。 - 價格 在計算新的文字請求保留金額時,會依該請求條件,考量標準或優先模式,以及估計輸入量可能達到的價格級距。在選定條件下,計算仍採保守方式;flex 模式不會降低保留金額。優先請求的保留金額可能採用適用模式中最高的價格,包括 priority、flex 或 fast。先前未納入這些條件的保留金額,仍維持按最高費率計算的原始方式。
- 降低上限 —當計算出的保留金額超過可用金額,且該模型與方法能限制回應長度時:可用金額必須足以支付估計輸入量與最低輸出量。降低後的上限不會低於 256 token (Anthropic 格式啟用思考時為 1025)。模型收到的是已降低的上限。
計算範例
模型claude-sonnet-5-5:每 1 百萬 token 的輸入價格為 $2,輸出價格為 $10。您傳送了 20 000 token,模型回應了 1 200 token。
| 步驟 | 計算 | 金額 |
|---|---|---|
| 實際輸入 | 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:清償欠款前,新的請求會暫停。
{
"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。每項請求都會顯示模型、token 數與金額。