了解基礎 URL
基礎 URL 定義了您的客戶端發送請求的位置。此處的不匹配會導致立即的連接失敗或意外的模型回應。許多開發者假設標準 OpenAI URL 可以通用，但無審查供應商通常使用不同的端點來將流量路由到特定的模型池。
驗證您的設定是否指向 https://api.openrouterabliteratedmodels.com/v1 用於我們的服務。如果您使用的是第三方聚合器，請確保基礎 URL 與他們的文件完全匹配。錯誤的 URL 通常會導致 404 錯誤，或從預設模型而非預期的無審查變體接收回應。
- 檢查您的環境變數中的
BASE_URL或API_HOST. - 確保路徑包含
/v1用於標準相容性。 - 在大量使用之前，透過簡單的模型列表請求測試連線性。
處理速率限制
速率限制會限制您在特定時間範圍內可以發送的請求數量。我們的 API 對每個金鑰實施每分鐘 300 次請求的限制。超過此閾值將導致 HTTP 429 錯誤，在時間視窗重置之前暫時阻止進一步的請求。
此外，每個密鑰的並發請求限制為同時 8 個請求。如果您發送超過 8 個同時請求，超出部分將排隊或失敗，具體取決於您的客戶端庫。監控您應用程序的並發性以避免觸發這些硬性限制。在代碼中使用指數退避策略來優雅地處理 429 錯誤，避免向服務器發送大量請求。
請記住，每個金鑰都是您帳戶獨有的。在多個服務之間共用金鑰可能會加速達到這些限制。如果需要為應用程式的不同部分提供單獨的速率限制池，請生成新的金鑰。
串流與非串流回應
串流回應隨著 token 生成逐步返回數據，而非串流則等待完整回應。串流對於即時使用者體驗至關重要，但需要謹慎處理伺服器發送事件（SSE）。
串流處理時，最後一個區塊包含權重使用統計數據。如果您提前停止處理，可能會錯過這些數據。確保您的客戶端解析最後一個 SSE 訊息，以準確獲取輸入和輸出權重計數。非串流回應更簡單，但對於長輸出可能會導致高延遲。
當使用者看到文字逐字出現時，請為聊天介面選擇串流傳輸。對於批處理或需要完整回應後才能繼續的情況，請使用非串流傳輸。我們的 API 透過 stream 參數於請求主體中。
JSON 模式錯誤
JSON 模式可確保模型輸出有效的 JSON，這對於程式化整合至關重要。此處的錯誤通常源於標頭不正確或結構描述不匹配。API 需要 response_format: {"type": "json_object"} 用於強制執行嚴格的 JSON 輸出。
如果您收到格式錯誤的 JSON，請檢查您的架構定義。模型可能會在 JSON 結構之外包含 Markdown 程式碼區塊或說明文字。使用能夠去除 Markdown 程式碼框或根據預期架構驗證輸出的強大解析器。避免使用過於複雜的架構以免混淆模型。
先從簡單的結構開始測試。逐漸增加複雜性，以找出模型的弱點。確保您的溫度設置恰當，因為較高的溫度會增加隨機性並降低 JSON 的有效性。
Token 計數誤差
Token 計數決定了您的計費和上下文視窗使用情況。計算錯誤可能會導致意外費用或回應被截斷。我們的 API 每 1M 輸入 Token 收取 $0.15，每 1M 輸出 Token 收取 $0.50。
使用與模型分詞方案匹配的可靠 tokenizer 程式庫。不同模型對空白或標點符號的分詞方式可能不同，導致本地計數與 API 計數出現差異。請始終依賴回應中返回的 token 用量以確保計費準確。
留意您的上下文窗口，總計為 100,000 個 token。超出此限制將導致錯誤。請截斷較舊的訊息或摘要以保持在範圍內。長期監控您的 token 使用量，以最佳化提示結構並降低成本。
加密貨幣支付延遲
透過 USDT (TRC20) 或 USDC (Base) 的加密貨幣充值在我們端即時處理。然而，網路擁塞有時會導致確認延遲。請確保發送正確的金額和網路，以避免資金損失。
充值金額為 $20 至 $500 的整數。額外信用額度自動應用：$50 起 +5%，$100 起 +10%，$200 起 +15%。驗證交易雜湊以確認付款。如果信用額度在幾分鐘內未出現，請在區塊鏈瀏覽器中檢查交易狀態。
信用永不過期，因此您沒有立即使用的壓力。像重複扣款這樣的錯誤可以通過支援頁面解決。保留您的交易記錄，以便在出現問題時輕鬆參考。
模型 ID 配置
模型 ID 標識您正在使用的無審查模型的版本。對於我們的服務，模型 ID 為 uncensored. 使用錯誤的 ID 可能會導致錯誤或意外行為。
確保您的請求指定 model: "uncensored" 請求主體中。此 ID 指向我們專門針對無限制回應進行微調的特定開放權重模型。它不是通用識別碼，而是指向我們託管實例的特定指標。
檢查您的客戶端庫的文件，了解如何設定模型 ID。某些庫使用 model 欄位，而其他欄位可能使用不同的參數。在應用程式中保持一致的 model ID 使用方式可避免混淆，並確保您始終呼叫預期的 uncensored 模型。
上下文視窗超出
上下文窗口限制了您在單一請求中可發送的 token 總數。我們的 API 支持 100,000 個 token 的窗口，包括提示詞與補全內容。超出此限制將導致錯誤。
要管理上下文，請實施滑動視窗策略。移除較舊的訊息或將其摘要以釋放空間。監控輸入的 token 數量，以確保其保持在 100,000 token 的限制內。如果您超過限制，API 將拒絕請求。
使用 max_tokens 用於控制輸出長度的參數。每個請求的最大輸出為 16,000 個 token。設定此參數有助於防止 token 過度使用，並使回應保持在應用程式可管理的範圍內。
支援與退款政策
額度一旦使用即不退款，但永不過期。若您在付款或服務方面遇到問題，請透過指定頁面聯繫「支援」。重複扣款等錯誤將由支援團隊解決。
對於技術問題，請先查看文件。我們的 API 簡單易懂，但仍可能出現邊緣情況。尋求協助時，請提供您的 API 金鑰和請求詳細資訊。回應時間可能有所不同，但我們會盡速解決問題。
請記住，信用額是預付的。您為消耗的內容付費，錯誤和拒絕是免費的。此模型確保帳單透明。如有任何差異或帳戶問題，請使用支援頁面。
