無過濾 AI 聊天：逐步整合指南

為何無過濾 AI 聊天對開發者很重要

開發角色扮演應用程式的開發者常面臨導致使用者體驗中斷的無聲拒絕。標準模型往往會降低內容品質，或基於模糊的「氛圍」檢查而非明確的政策違規來阻止請求。無過濾的 AI 聊天解決方案移除了這些任意守門人，讓您的應用程式能夠處理多樣化、成熟或具爭議性的主題，而無需不斷摩擦。對於重視一致性勝過通用安全性的內容管線而言，這種可靠性至關重要。

我們的基礎設施專門為成人和無限制內容的請求服務。我們不會因為內容是「NSFW」而降低你的流量優先級。相反地，我們提供通往無限制模型的直接路徑，該模型根據上下文而非隱藏的審核層來回答問題和生成故事。這種方式確保你的使用者能從專用的聊天機器人獲得他們預期的原始、未經修飾的創意。

設定您的環境

首先為您偏好的語言安裝官方的 OpenAI SDK，因為我們的 API 遵循標準的 chat-completions 協定。您需要設定環境變數以安全地儲存您的 API 金鑰。設定過程非常簡便，因為我們依賴現有的產業標準。

使用您的套件管理器安裝函式庫。對於 Python，請使用 pip install openai。對於 Node.js，請使用 npm install openai。安裝後，匯入客戶端並使用您的基礎 URL 初始化它。此步驟確保所有後續呼叫正確路由至我們的伺服器。保持您的金鑰私密，除非使用代理，否則不要在客戶端程式碼中公開它。

配置基礎 URL

將您的客戶端指向 HTTPS://api.storyunfiltered.com/v1 以存取無審查端點。此基礎 URL 取代 SDK 設定中的預設 OpenAI 端點。通過更改此單一變數，您可以將應用程式從標準 GPT 模型切換到我們專用的無審查大型語言模型。您必須在請求中指定的模型 ID 為 "uncensored"。此標識符告訴伺服器將您的流量路由到哪個特定實例。

通過發送簡單的測試請求來驗證配置。檢查 GET /v1/models 端點以確認模型是否可用。回應應列出 "uncensored" 作為可用模型。此驗證步驟確保您的環境在開始構建複雜功能之前已正確連接。它還確認您生成的 API 密鑰已激活並與您的預付信用額度關聯。

使用您的 API 金鑰驗證

將您的 API 金鑰以 Bearer token 的形式傳入 Authorization 標頭。我們支援透過 Google 登入或電子郵件與密碼來產生金鑰。金鑰在建立後會立即顯示，請將其複製到您的環境變數中。每個帳戶僅持有一個有效金鑰；產生新金鑰會立即取代舊金鑰。這簡化了金鑰輪替流程，並降低過期憑證殘留於系統中的風險。

註冊不需要電話號碼，且僅儲存您的電子郵件以維護隱私。提示詞不會用於訓練您的數據，這對於企業或注重隱私的應用至關重要。金鑰不會過期，但附帶的預付信用額度也沒有硬性過期日期。錯誤和拒絕不會消耗您的餘額，因此您可以自由測試而無需擔心意外費用。

發送您的第一個請求

向 /v1/chat/completions 發送標準 POST 請求，並將模型設定為 "uncensored"。包含您的系統提示以定義人格，並新增使用者訊息以推動對話。上下文視窗支援 100,000 個 token，用於提示和補全的總和。這允許您傳遞大型文件或長對話歷史而不會立即截斷。確保您的有效載荷保持在 8 MB 請求主體限制之下。

設定 temperature 和 top_p 參數以控制創意。較高的 temperature 會產生更多樣化的輸出，非常適合角色扮演。較低的 temperature 可確保事實性或結構化任務的一致性。該模型透過 response_format 支援 JSON 模式，允許您為資料擷取任務強制執行結構化輸出。這種靈活性使 API 適合用於休閒聊天和生產級整合。

處理串流回應

在請求中將 stream 設為 true。API 回傳伺服器發送事件（SSE），包含生成時的 partial 回應。這改善了最終用戶的感知延遲，即使對於長輸出，聊天感覺也具有回應性。每個區塊包含增量內容，您的應用程式必須將其連接以形成最終回應。

串流中的最後一個區塊包含 token 使用數據。利用此數據可精確追蹤您的額度消耗。我們對每 1M 個輸入 token 收取 $0.15，對每 1M 個輸出 token 收取 $0.50。帳單基於實際使用量，因此部分回應會按比例計費。這種透明度讓您可以直接在應用程式邏輯中實作成本控管。

實作工具呼叫

我們的 API 支援 function calling，允許模型根據使用者意圖調用外部工具。在 tools 參數中定義您的函數，包含名稱、描述和參數 schema。如果模型判斷需要函數，它將回傳包含 tool_calls 的回應。您必須執行該函數，並在後續訊息中回傳結果。

此功能支援複雜的工作流程，例如查詢天氣、資料庫查詢或網頁爬蟲。uncensored 模型處理工具定義的精確度與標準模型相同。然而，請注意我們不提供嵌入向量或微調功能。如果您的應用程式依賴向量搜尋或自訂模型訓練，此 API 可能不適合。請堅持使用直接聊天完成（chat-completions）以獲得最佳結果。

最佳化成本與速度

透過減少不必要的 API 呼叫來最大化預付信用的效用。在測試期間使用 seed 參數以獲得確定性輸出。調整 max_tokens 限制以防止模型生成過長的回應而耗盡您的餘額。預設輸出限制為 2,048 個 token，但您可以將其增加至每次請求 16,000 個 token。這對於在單一呼叫中生成長篇故事或詳細報告非常有用。

監控您的請求速率以保持在每分鐘 300 次請求的限制內。如果您超過此限制，將收到 429 錯誤。在您的客戶端程式碼中實施指數退避，以優雅地處理重試。由於錯誤免費，您可以無損地重試失敗的請求。這種安全網確保了在高峰使用期間的可靠性。

排除常見錯誤

如果您收到 401 錯誤，請驗證您的 API 金鑰是否正確且有效。檢查基礎 URL 是否完全匹配 HTTPS://api.storyunfiltered.com/v1。404 錯誤通常表示端點路徑有拼寫錯誤。確保您使用正確的 HTTP 方法，聊天補全使用的是 POST。如果錯誤持續，請從儀表板重新生成金鑰。

429 錯誤表示您已超過每分鐘 300 次請求的速率限制。請等待窗口重置或降低請求頻率。如果遇到 413 錯誤，表示您的請求主體超過了 8 MB 的限制。請簡化您的負載或減少上下文窗口大小。這些錯誤是 REST API 的標準錯誤，可以透過仔細除錯來解決。