【2026 最新】OpenRouter 花費上限怎麼設？硬額度、故障演練與 Agent 續跑收據

你讓 AI Agent 在背景整理資料，去睡一覺，醒來最怕的不是它答錯，而是它不停重試，帳單繼續長。OpenRouter 花費上限到底哪一層真的會讓請求停下？停下後，又怎麼讓任務接著跑而不重做？

這篇寫給第一次管理 API 花費、但願意照著控制台操作的讀者。你會設定四道控費閘門、用低額測試演練被拒絕時的流程，最後拿到一張可交給自己或同事的「續跑收據」。本文是依截至 2026 年 10 月 5 日的官方文件整理的操作範本；測試步驟留給你在自己的帳戶執行。

先說結論：OpenRouter 花費上限要分四層

一句話記住：先鎖錢包，再鎖鑰匙；單次請求設護欄，Agent 被拒絕就保存現場。預付餘額且關閉 Auto Top-Up，是阻止卡片自動繼續扣款的邊界；每把 API Key 的 credit limit 控制個別工作；max_tokens 和 provider.max_price 只控制每次呼叫的部分成本。這四層功能與超額邊界可對照 OpenRouter 官方控費說明。

把它想成出門帶錢：預付餘額是錢包裡實際放多少錢；Key 額度是給每位跑腿人的預算；單次參數是每筆採購的規則；續跑收據記下誰買到哪一步。手機通知只是在叫你看錢包，不能代替停止規則。

為什麼 Agent 特別需要「停下後怎麼辦」？

一般聊天多半一問一答；Agent 可能把前文、檔案和工具結果帶進下一輪，還會自己決定再呼叫模型。一次任務如果重試、並行或反覆傳送長上下文，就會累積請求。先讀 Agent Harness 的循環原理，再把每一圈想成一筆可能付費的交易。

所以你要同時回答兩題：哪裡擋住新的收費，以及被擋住時能否安全恢復。如果程式在收到拒絕後立刻換另一把 Key、另一個供應商或無限重試，原本的額度設計就失去意義。這是你的 Agent 流程規則，並非 OpenRouter 代你保存任務進度。

OpenRouter 花費上限：四道閘門怎麼設定？

① 預付＋關閉 Auto Top-Up：先決定卡片最多自動付多少

到 Credits 頁面 查看餘額，確認 Enable auto top up 為關閉，再只購買這次能接受的預付額度。官方說明指出：餘額用盡後請求會失敗，關閉自動加值後卡片不會自行替帳戶補錢；開啟時，餘額低於門檻可能自動扣卡。詳見 Auto Top-Up 官方說明。

白話說，這道閘門限制的是這個 OpenRouter 帳戶之後是否自動向卡片買更多 credits。已購買的 credits 是已發生的支出；也要確認你的 Agent 沒有另一條直接向模型供應商付費的路。

② 每把 Key 設 credit limit：讓一個任務只拿到小錢包

到 API Keys 頁面 為這個 Agent 新建專用 Key，填入你願意給這個任務的美元額度。固定一次性任務可不設重置；長期服務可按天、週或月重置。管理 API 的 Create API key 規格 也列出 limit 與 limit_reset，其中 null 代表不自動重置。

一把 Key 配一個任務或環境，比共用 Key 容易對帳。別把「已到限額」寫成精確到最後一分的結算保證：官方明說，系統在送出請求前檢查限額，成本要等完成後才知道，大請求與並發可能使該 Key 的最終用量略超。

③ max_tokens：限制單次回覆長度

如果工具有模型設定，先找 max_tokens 或回覆長度上限。直接呼叫聊天 API 時，可在請求本文放 "max_tokens": 1024，意思是允許模型最多產生約 1024 個輸出 token；它不替你限制輸入檔案、工具成本或整個任務的總花費。現行 聊天 API 規格 同時列出 max_tokens 與 max_completion_tokens，並將前者標為 deprecated；新整合應先核對所用 SDK 與模型支援的欄位。

④ provider.max_price：拒絕高於單價門檻的供應商端點

在可編輯 OpenRouter 請求參數的工具中，可加入 "provider":{"max_price":{"prompt":5,"completion":15}}。兩個數字的單位是「每百萬 token 美元」；它會篩掉高於門檻的供應商端點，若沒有合格端點，請求就失敗。這不是總帳單 5 或 15 美元的上限。數值只是示範，請對照你選的模型與端點的當前價格再填。官方範例見 控費文件中的參數示例。

如果你還用了 BYOK（自己的供應商 Key），支出還可能落在供應商帳戶。OpenRouter 的 BYOK 說明 指出供應商 Key 能在供應商端控制費率與成本，也有 OpenRouter credits 的費用規則。這時要把供應商帳單一起納入總預算，別只看 OpenRouter Credits。

一個完整例子：讓資料整理 Agent 遇到額度就留下收據

假設你要整理十篇公開文章，預算只想放在一個小額 Key。以下金額只是你自行設定的練習值，不是官方價格，也不是 AlphaLab 的測試結果。先把 Auto Top-Up 關掉，替練習建立專用 Key；將 Key 額度設成你願意耗掉的低額，再把 Agent 的同時請求數設為 1，方便看清先後順序。

1. 在 Agent 開始前，把待辦拆成十個可辨識項目，每項有來源 URL、輸出檔名與狀態 pending。先保存這張清單。
2. 每完成一項，就先把輸出寫入暫存檔，檢查內容，再原子地改名為正式檔；同步把該項狀態改成 done，記下請求 ID 或時間。
3. 當 OpenRouter 回應顯示 credit／key limit 類拒絕時，停止排入新請求。保留 HTTP 狀態、錯誤類型與時間，不把任何祕密 Key 寫入收據。不要把 402 當成所有額度拒絕都一定使用的狀態碼；依實際錯誤本文辨識。
4. 檢查已完成項目的檔案，再核對 Activity 與 Credits；必要時也看 BYOK 供應商帳單。先決定是否增加預算，再以「只挑 pending 項目」的方式續跑。

這份流程的核心不是「自動補錢」，而是先保全完成品，再請人決定是否繼續花錢。如果你把超限錯誤歸類為一般網路故障並無限重試，Agent 可能一直空轉；如果換另一把 Key 自動繼續，則可能繞開你剛設的邊界。Agent Harness 實作範例 可幫你理解停止條件放在哪個執行圈。

可直接照抄的「續跑收據」欄位

每次停下時，讓 Agent 產出一份純文字或 JSON 收據。至少包括：task_id（任務代號）、budget_key_label（Key 名稱，不含祕密）、completed_items、pending_items、output_paths、last_request_id、last_error_status、stopped_at_utc、resume_requires_human_approval。

範例：{"task_id":"reading-list-01","completed_items":["article-01","article-02"],"pending_items":["article-03"],"last_error_status":null,"resume_requires_human_approval":true}。這是收據格式示例，不是一筆真實 API 回應。真正續跑前要檢查完成檔案仍在、未完成項目沒有部分寫入，並確定同一任務不會在別的背景程序同時跑。

收據本身不是供應商帳單。OpenRouter 的 Generation 查詢 API 提供單次請求的 usage 與 total_cost；Activity API 可按端點看近期用量。用它們對照 Agent 的本機紀錄，才能看出漏記、重試與並發。

故障演練：用低額 Key 驗證你的停止邏輯

先用你願意花掉的最低練習額度做一次性測試：專用 Key、Auto Top-Up 關閉、同時請求數 1，讓 Agent 處理幾個可重跑的小項目。把 Key 額度設得夠低，使任務有機會遇到拒絕；不要為了逼出錯誤而送超大的單次請求。觀察到拒絕後，確認新請求停止、收據生成、已完成檔案保留、未完成項目仍可辨識。

如果低額測試沒有碰到限額，記下「未觸發」並檢查設定與 Activity；這不是通過故障演練。如果發生並發或單次超額，記錄超額範圍及請求數，別把它說成平台保證的公差。對長時間遠端任務，Pi pod 的隔離與續跑驗收 也示範了如何分開看任務狀態和環境邊界。

常見的四個坑

• 把通知當硬停。看板與提醒能幫你早發現花費，真正的請求拒絕仍要靠 Credits、Key 限額及 Agent 自己的停止規則。
• 把 max_price 當總額。它限制的是供應商端點每百萬 token 單價；一個任務可呼叫很多次。
• 把 Key 上限當精確結算。並發和在途請求的實際成本在事後入帳；測試時先讓同時請求數為 1。
• 只看一張帳單。若有 BYOK、備用 Key 或直接供應商通道，逐一核對支付來源。

想降低日常 token 浪費，可以接著看 如何節省 Claude token；若你正在比較模型路由，Weave Router 的完成成本驗收 會提醒你把重試和人工收尾一起算進去。

常見問題 FAQ

1. 關掉 Auto Top-Up，所有 AI 費用就一定歸零嗎？

不會。它阻止此 OpenRouter 帳戶自動購買新 credits；既有 credits 仍會消耗，其他供應商帳戶的支出仍要另外檢查。

2. Key limit 到了會精確停在設定值嗎？

不一定。官方說大請求及並發請求可能使最終用量略超，因為發送前檢查與完成後計價之間有時間差。

3. max_tokens 是整個 Agent 任務的上限嗎？

不是。它針對單次模型回覆的 token 數；下一輪請求還會再計費。

4. provider.max_price 等於每次請求最多花 15 美元嗎？

不是。範例中的 15 代表 completion 每百萬 token 的供應商價格門檻，與單次總費用不同。

5. 遇到 402 就能直接當成 Key 額度用盡嗎？

不能直接推定。聊天 API 把 402 列為 Payment Required；請同時看錯誤本文、Credits、Key 狀態與 Activity，再判斷是餘額還是其他付款問題。

6. Agent 被拒絕後要自動換 Key 嗎？

這份流程不建議。若目標是讓人確認額度，應先停下並出收據；更換 Key 需要明確的新預算決定。

7. 我沒有寫程式，也能做這個演練嗎？

可以先做前三層。關閉 Auto Top-Up、建立小額專用 Key、在工具介面設定輸出長度，然後觀察 Activity。若工具不能導出任務狀態，就用人工清單記錄完成項目。

8. 收據能代替對帳嗎？

不能。收據記工作進度；花費以 OpenRouter Activity／Credits 及任何直接供應商帳單核對。

給新手的三個重點

• 先鎖錢包：買有限 credits、關閉 Auto Top-Up。
• 再鎖鑰匙：一個任務一把低額 Key；單次限制只是輔助。
• 被拒絕就保留現場：停止新請求、留下收據、對帳後由人決定是否續跑。