使用錯誤的 base_url
使用標準的 OpenAI 基礎 URL 會導致您的請求失敗或路由至不同的模型。我們的 API 要求您更改 base_url 以 https://api.whatisopenrouterai.com/v1. 這一行設定確保您的 SDK 連線至我們的伺服器，而非全球 OpenAI 基礎設施。
許多開發者在複製貼上現有代碼時未更新此變數。如果你保留預設 URL，你將收到 404 錯誤或命中一個非無審查的模型。始終通過檢查 /v1/models 端點。您應該會看到我們特定的模型 ID 列在那裡。這確認了路由設定正確，之後您才能發送第一個完成請求。
忘記設定模型 id
即使使用正確的基礎 URL，省略模型 ID 也會預設為通用或較舊的模型。你必須明確設定 model 參數至 "uncensored" 每次請求中。這告訴我們的路由層提供針對無限制內容進行微調的特定開放權重模型。
若沒有此明確指示，您可能會收到具有不同對齊規則的其他模型。某些模型預設會拒絕合法的成人主題。透過強制 uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
忽略記號限制與錯誤
超出 100,000 token 的上下文視窗或 16,000 token 的輸出限制會導致請求立即失敗。我們的 API 強制執行每次請求最多 16,000 個 token 的輸出上限。如果您未設定 max_tokens, 預設值僅為 2,048 個 token。這對於複雜的推理任務通常太短。
錯誤與拒絕不會消耗您的預付信用額度。然而，觸發速率限制或超出主體大小（8 MB）的格式錯誤請求仍會佔用您的配額。請監控響應頭中的 token 使用情況。調整您的提示工程以適應上下文窗口。這可防止昂貴的重試並確保數據流暢。
誤解預付帳單
您的帳戶餘額與預付信用額度掛鉤，而非月費訂閱。我們對每 1M 個輸入 token 收取 $0.15，對每 1M 個輸出 token 收取 $0.50。錯誤免費，但成功的生成會消耗信用額度。您必須透過加密貨幣充值以維持服務可用性。
我們接受 USDT (TRC20) 或 USDC (Base) 進行充值。最低存款為 $20。較高層級享有贈送餘額：$50 起贈 5%，$100 起贈 10%，$200 起贈 15%。餘額永不過期。在運行大批次請求前，請確保餘額為正。請查看儀表板以驗證您的當前餘額和最近交易。
將串流與標準回應混淆
透過 SSE 串流會改變您解析回應串流的方式。標準回應返回單一 JSON 物件。串流返回多個區塊。您必須處理最後一個區塊以獲取準確的 Token 用量統計數據。
我們的串流實作包含最後一個區塊中的 token 用量。如果您提前停止讀取串流，可能會遺失此資料。請確保您的客戶端程式庫能正確支援 SSE。這對於即時應用程式至關重要，因為您需要即時顯示生成的 token。串流配置不當可能會導致文字不完整或 UI 狀態異常。
tool_choice 設定錯誤
不正確 tool_choice 設定可能會導致函數調用無法按預期工作。您可以強制使用特定工具或讓模型自行決定。配置錯誤通常導致模型忽略可用函數。
使用 tool_choice 用於控制模型是否自動呼叫工具。將其設定為 "auto" 用於靈活性或指定工具 ID 以獲得嚴格行為。確保您的函式定義符合預期的 schema。這可避免模型嘗試呼叫不存在的函式時發生執行階段錯誤。在部署至生產環境之前，請徹底測試您的工具定義。
缺少 json_object 模式
沒有 response_format: {"type": "json_object"}, 模型可能會輸出 Markdown 或純文字。這會破壞預期嚴格 JSON 的解析器。啟用 JSON 模式以確保一致且可解析的輸出。
此功能對於需要結構化資料的下遊系統整合至關重要。它大幅減少了後處理開銷。請始終在客戶端程式碼中驗證輸出 schema。這可確保對偶爾出現的模型幻覺具有韌性。當提取實體或生成設定檔時，請使用此模式。
速率限制意外情況
我們的 API 每金鑰每分鐘允許 300 次請求。超出此限制將導致 429 Too Many Errors 回應。每金鑰的併發請求限制為 8 個。請相應地規劃您的併發設定。
如果您運行多個進程，請確保它們共享同一個金鑰或生成獨立的金鑰。每個帳戶僅支援一個活躍金鑰。新金鑰將取代舊金鑰。請監控回應中的速率限制標頭。在重試邏輯中實施指數退避機制。這可防止在高流量期間發生級聯故障。
加密貨幣充值延遲
區塊鏈交易可能需要時間才能確認。發送資金後，您的餘額可能不會立即顯示。請使用正確的網路：USDT 使用 TRC20，USDC 使用 Base。發送到錯誤的網路會導致資金損失。
充值金額介於 $20 至 $500 之間。請確保匯入確切金額或考慮網路手續費。請在區塊鏈瀏覽器上檢查交易雜湊。如果信用額度延遲到帳，請附上交易 ID 聯繫支援。不要假設付款立即失敗。在網路擁塞期間保持耐心是順暢操作的關鍵。
