Uncensored ia：常見錯誤排除

為何您的無審查 ia 模型沒有回應

你的客戶端收到無回應的主要原因是 SDK 設置與 API 需求之間的配置不匹配。大多數開發者複製貼上標準的 OpenAI 範例，卻未調整端點或模型標識符。這會導致 404 或 400 錯誤，因為預設客戶端指向了錯誤的基礎設施。請驗證你的 HTTP 客戶端是否確實連接到伺服器並接收到有效的 JSON 載荷。

檢查您的網路日誌以查找逾時錯誤。若連線成功但返回空載體，模型 ID 可能不正確。無限制 ia 模型需要特定的參數，如 temperature 和 top_p，才能正常運作。若缺少這些參數，某些客戶端可能會發送伺服器靜默拒絕的格式錯誤請求。請確保您的程式碼能優雅地處理 HTTP 錯誤，而非假設請求成功。

base_url 錯誤：使用 OpenAI 而非 Dolphin

使用預設的 OpenAI 基礎 URL 是切換至此無審查 AI 服務時最常见的錯誤。您的程式碼預設會將請求傳送至 HTTPS://api.openai.com/v1，該處並未託管我們的模型。這會導致「找不到模型」的錯誤，因為 OpenAI 無法識別我們特定的端點識別碼。

更新您的客戶端配置，指向 HTTPS://api.dolphinia.cc/v1。此變更將您的流量導向我們的伺服器，無審查大型語言模型即位於此處。請求結構與其他標準 OpenAI 呼叫完全相同。您無需重寫整個應用程式邏輯。只需更新基礎 URL，並確保您的 API 金鑰對此網域有效即可。

模型 ID 錯誤：發送 'gpt-4' 而非 'uncensored'

即使使用正確的基礎 URL，發送 'gpt-4' 或 'gpt-3.5-turbo' 也會失敗。伺服器期望在模型欄位中使用精確的字串 'uncensored'。此字串標識運行在我們基礎設施上的特定開放權重模型。它不是通用佔位符，而是你正在訪問的無審查 AI 模型的精確標識符。

檢查您的程式碼中是否有硬編碼的模型名稱。許多庫在欄位為空或配置錯誤時，預設會使用 'gpt-4'。請在初始化參數中明確將模型 ID 設定為 'uncensored'。這能確保請求傳送至正確的神經網路。請驗證回應中是否包含正確的模型名稱，以確認切換成功。

處理 uncensored ia 中的 JSON 模式錯誤

JSON 模式錯誤通常源於未在請求中明確定義回應格式。無審查的 ia 模型可以輸出結構化資料，但必須正確設定 response_format 參數。若無此指示，模型可能會回傳純文字或格式錯誤的 JSON，從而破壞您的解析器。

在 API 呼叫中設定 response_format 為 {"type": "json_object"}。這強制模型遵循嚴格的 JSON 語法。確保您的提示清楚地定義了預期的 schema。uncensored LLM 隨後會將其輸出結構化以符合您的需求。這種方法減少了解析錯誤並提高了自動化管線的可靠性。

串流問題：遺漏包含用量資料的最後一個區塊

串流回應以區塊交付資料，但 token 使用統計資料通常只出現在最後一個區塊中。如果您提前停止監聽串流，就會遺失這項關鍵的計費資訊。這可能導致成本追蹤不準確和意外的超支。

確保您的程式碼處理每個區塊，直到串流結束。最後一個區塊包含 finish_reason 與使用統計數據，請勿將其丟棄。這些資料對於驗證請求是否成功完成至關重要。透過 SSE 串流可提供即時更新，但您必須處理串流結束事件，才能掌握完整資訊。

Token 限制：了解 16k 輸出上限

無審查 ia API 對輸出有 16,000 token 的硬性限制。如果您的提示詞很長，剩餘的完成空間就會相應縮小。超過此限制將導致截斷錯誤或 400 Bad Request 回應。

密切監控您的輸入令牌計數。總上下文視窗為 100,000 個令牌，但輸出上限更嚴格。如果您需要更長的回應，請考慮將請求分解為較小的區塊。這確保您保持在 16,000 個令牌的限制內。始終檢查回應中的令牌使用情況，以準確規劃後續步驟。

驗證失敗：檢查您的 API 金鑰格式

驗證失敗通常是由於 API 金鑰無效或過期所致。請確保您的金鑰複製正確，沒有額外的空格或換行符。uncensored ia 服務要求每個請求都必須在 Authorization 標頭中傳遞有效的金鑰。

驗證金鑰格式是否符合預期的字串。如果您重新生成了金鑰，請立即更新您的客戶端設定。無效的金鑰會導致 401 Unauthorized 錯誤。檢查您的帳戶儀表板以確認金鑰狀態。一個簡單的打字錯誤可能會中斷您的整個流程，因此在部署前請再次檢查值。

速率限制：每分鐘 300 次請求的樣貌

無審查 ia API 允許每個金鑰每分鐘 300 個請求。此限制適用於所有端點的總和。如果您超過此閾值，將收到 429 Too Many Requests 錯誤。這在高吞吐量應用程式或批次處理情境中很常見。

在您的重試邏輯中實作指數退避。這可防止在達到限制時淹沒伺服器。監控您的請求速率以保持在界限內。每個金鑰的 8 個併發請求限制也適用，因此請避免發送太多平行串流。調整您的併發設定，以維持穩定的吞吐量而不觸發速率限制。

計費意外：為何錯誤免費但輸出需付費

計費意外通常發生在用戶誤以為每個生成的 token（包括錯誤）都需付費時。在我們的 uncensored ia 服務中，錯誤與拒絕請求免費。您僅為成功的輸出 token 付費。這意味著失敗的請求不會產生費用。

然而，輸出 token 按每 1M token $0.50 計費。輸入 token 按每 1M token $0.15 計費。確保您的程式碼準確追蹤使用情況，以避免意外成本。預付額度模型按實際 token 使用量收費。錯誤不會消耗額度，但有效的輸出會。定期監控您的餘額以保持在預算內。