OpenRouter 免費模型回傳 429 時，先暫停批次，查清楚是短時間送太多，還是今天的額度已用完。 這篇適合正在台灣做原型、串接自動化或練習 API 的讀者。準備錯誤回應與帳號的剩餘請求數，就能判斷該放慢、等重設，或處理供應端容量；不要一看到 429 就反覆按重試，或直接儲值。
例如，用免費模型整理 30 份文章，每份先摘要、再分類，至少就是 60 次呼叫。即使每次只有幾行文字，也不能把它當成「只問了 30 次」。Agent 的工具迴圈與失敗重送還可能增加次數。免費模型沒有 token 費用，不表示請求數量無限制。
以下聚焦 Chat Completions 的免費用量排錯，官方規則查核至 2026 年 10 月 4 日。若尚未建立 key 或跑過第一個請求，先看 OpenRouter API 教學。範例數字為假設，未以私人帳號測試供應商當下容量。
先查每日額度，別把 credits 當請求數
用自己的程式送出 GET https://openrouter.ai/api/v1/key，在 Authorization 標頭帶入 Bearer 加上自己的 API key。回應的 data 裡，free_model_daily_requests 的 used、limit 與 remaining 分別表示今天記錄的次數、每日上限及剩餘次數。另一個 limit_remaining 是 key 的金額額度，兩者不要混用，也不要把 key 貼到第三方排錯網站。
Limits 文件 目前列出，一般免費用量為每分鐘 20 次、每日 50 次；累計購買至少 10 美元 credits 的級距，可提高到每日 1,000 次，每分鐘仍是 20 次。這個門檻依累計購買計算，並非每次查詢的當下餘額。文件另有吸收手續費與四捨五入的級距緩衝，因此實際每日上限以回應的 limit 核對；只看 is_free_tier 是否為 false，不能推定自己有 1,000 次。
每日計數依 UTC 日切換，對台灣就是上午 8 點換日。若下午用完每日額度，等到台灣午夜並不會開始新的一天。BYOK 或獲豁免的帳號／端點有不同適用範圍，不能把這個欄位當成每種路由的硬性上限。
回到 30 份文章的例子：如果帳號每日上限是 50 次、今天已用 19 次，就只剩 31 次。先做少量樣本，估計每份需要幾次呼叫，再決定拆到隔日或改變處理方式；不要等佇列走到一半才發現剩餘份數與剩餘請求不相等。
同樣是 429，等待方式有三種
保留錯誤發生時間、請求的模型、HTTP 狀態、回應內的 error，以及相關回應標頭。分享紀錄前移除 Authorization、key 和私人輸入內容，留下能辨識錯誤的資訊即可。
| 你看到的線索 | 先判斷什麼 | 下一步 |
|---|---|---|
每日 remaining 已到 0 | 每日額度可能已用完 | 停止該批次，安排換日後續跑 |
| 每日還有剩餘，但短時間密集呼叫 | 可能碰到每分鐘限制 | 降低同時執行量，依回應提示等待 |
| 回應含供應端錯誤，仍有平台額度 | 可能是 provider 容量或限流 | 稍後再試，或評估其他合格端點／模型 |
這張表用來安排排查順序，不是僅憑一個數字就斷定原因。官方指出，平台限流的 429 回應會帶 X-RateLimit-* 標頭；有供應端原始錯誤碼時，也會提供 provider_code。成功的推論回應不會帶那組限流標頭，所以不要因成功回應看不到它，就以為額度查詢壞掉。
若狀態其實是 402，改查金額限制、餘額與錯誤指出的來源。官方也提醒負的 credits 餘額可能影響免費模型。402 與 429 的處理不同，建立另一把 key 也不會增加平台管理的容量。需要釐清自帶供應商 key 的帳單時，再看 OpenRouter BYOK 費用與預算。
重試要有停止條件，切換模型要有費用界線
有 Retry-After 時，依它指定的等待時間再送；沒有時，可逐步拉長間隔，並設定最多嘗試次數。應用程式最好把失敗項目留在待處理清單，讓使用者知道還有哪幾份沒完成。這比一個無限重送、看似持續運作的進度條更容易補救。
先檢查所用 SDK 是否已自動重試，再決定應用程式要不要另加一層。官方 錯誤處理文件 說明部分 SDK 會遵循重試標頭；兩層都重送時，實際呼叫可能多於介面顯示的次數。官方 成本教學 也提醒，失敗的免費請求仍計入每日用量。日額度用完後，幾秒一次的重試不會讓它恢復。
切換模型時先看 model ID。:free 只適用於目錄中有免費項目的模型，不能任意加在所有付費 ID 後面。openrouter/free 則會按所需能力篩選，再從可用免費模型中選擇；它不是固定同一個模型。若要比較摘要品質，需記錄實際回傳的 model，不要把不同模型的結果混成同一組測試。
供應端容量不足時，可以考慮 fallback；但它不會增加帳號的每日免費額度。官方 fallback 文件 說明，最後依實際用到的模型計價。只想免費練習，就核對備援清單裡每個項目；需要付費備援時，先確認價格與預算，再開啟。對客戶有完成時間承諾的流程，也應另設失敗回報，不能只靠免費模型輪流嘗試。
最後，串流已開始後仍可能在回應內出現錯誤，HTTP 狀態維持 200。檢查 error 與 finish_reason；已有部分答案時，別把殘缺內容標成完成，或直接把另一份重試結果接在後面。保留原始輸入與失敗項目，才能重新處理而不弄亂批次結果。
先完成小批、算清楚一次任務要幾次呼叫，再擴大規模。若需求主要是不用付費的日常工具，可從 免費 AI 工具整理 選擇較符合使用方式的入口，不必先維護一套 API 重試流程。
FAQ
OpenRouter 免費模型額度在台灣幾點重設？
官方每日計數使用 UTC 日，換算台灣為上午 8 點。這是每日額度的換日時間；每分鐘限流或供應端容量問題，要依當次錯誤與等待提示處理。
儲值後，免費模型就不會出現 429 嗎？
仍可能出現。符合購買門檻可提高每日免費上限，但目前每分鐘仍為 20 次，也無法保證供應端容量。先確認實際每日 limit 與錯誤來源，再決定是否需要付費。
換 key 或改用 openrouter/free，會重新得到每日額度嗎？
不能把換 key 或路由當成重設帳號容量的方法。openrouter/free 會挑選可用免費模型，無法保證固定模型、一定成功，或突破適用的免費用量限制。
參考來源
- OpenRouter：Limits，每日／每分鐘與金額限制；未標發布日期，2026-10-04 查核。
- OpenRouter：Errors and Debugging，重試與串流錯誤；未標發布日期，2026-10-04 查核。
- OpenRouter：Free Variant，免費項目的適用範圍；未標發布日期，2026-10-04 查核。
- OpenRouter：Free Models Router，路由選擇與可用性；未標發布日期，2026-10-04 查核。
- OpenRouter：Model Fallbacks，備援順序與計價；未標發布日期，2026-10-04 查核。
- OpenRouter：Lowest-Cost LLM Inference，2026-06-12 發布、2026-09-24 更新，2026-10-04 查核；用於失敗請求計數說明。