uncensored.com LLM API 逐步整合

前置條件：SDK 與環境設定

安裝您偏好的語言 SDK 以與端點通訊。大多數開發者使用官方的 OpenAI SDK（適用於 Python、Node.js 或 Go）。這是因為 API 遵循標準的 OpenAI 聊天完成架構。

確保您的環境已安裝 Python 3.8+ 或 Node.js 18+。請透過 pip 或 npm 安裝套件。您需要從開發者儀表板取得 API 金鑰。註冊時無需提供手機號碼。

• Python： pip install openai
• Node.js： npm install openai

將您的 API 金鑰儲存在環境變數中。這可防止金鑰在版本控制中被意外洩露。該金鑰可存取 uncensored 模型。

配置基礎 URL

將您的 SDK 客戶端指向正確的基礎 URL。這是成功整合最關鍵的一步。預設的 OpenAI 基礎 URL 在此服務中無法運作。

將基礎 URL 設定為 HTTPS://api.uncensoredaicom.com/v1。這將請求導向 uncensored LLM 基礎設施。您必須發送的模型 ID 為 "uncensored"。這是一個針對最小拒絕率進行微調的開放權重模型。

通過調用 models 端點來驗證連接。這確認您的憑證和基礎 URL 是否正確。成功的回應將返回 model id 和對象類型。

驗證與標頭設定

將您的 API 金鑰傳入 Authorization 標頭。請對所有請求使用 Bearer 方案。此標頭用於驗證您的預付帳戶。

將標頭設定為： Authorization: Bearer YOUR_API_KEY. 如果您將金鑰傳遞給客戶端建構子，SDK 會自動處理此步驟。請確保沒有包含額外的空白字元。無效的金鑰會返回 401 Unauthorized 錯誤。

每個帳戶有一個有效的金鑰。生成新金鑰會使前一個金鑰失效。這簡化了金鑰旋轉和安全管理。將你的金鑰安全地保存在你的部署環境中。

發送標準聊天請求

向 /v1/chat/completions 發送 POST 請求。將您的訊息作為包含 role 和 content 物件的陣列傳送。系統支援 user、assistant 和 system 角色。

結構範例： {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API 回傳文字補全。上下文視窗總計為 100,000 個 token。每次請求的最大輸出為 16,000 個 token。

錯誤與拒絕不消耗信用額度。這可保護您的預付餘額。設定 temperature 和 top_p 以進行控制。預設值適用於大多數使用案例。

啟用串流以獲取即時輸出

設定 stream: true 在你的請求主體中。這會啟用伺服器發送的事件 (SSE)。Token 會增量到達，無需等待完整完成。

解析 SSE 串流以即時顯示文字。最後一個區塊包含 Token 用量統計。這有助於準確追蹤計費。串流可降低終端使用者的感知延遲。

優雅地處理網路中斷。如果串流斷開，請重新連線。uncensored API 支援穩定的串流。監控連線狀態。這適用於聊天介面或長篇生成。

使用工具和函數調用

在請求主體中定義工具。傳遞函式架構的列表。模型可根據使用者意圖呼叫這些函式。這能實現類似代理（agent）的行為。

指定 tool_choice 控制函式選擇。使用 auto 用於自動偵測。API 支援標準工具定義。從回應中解析函式呼叫參數。

在您的程式碼中實作函數執行。將結果作為訊息發送。模型繼續對話。這實現了複雜的工作流程。測試確保準確的參數解析。

處理 JSON 模式回應

設定 response_format: {"type": "json_object"}. 這可強制模型輸出有效的 JSON。適用於結構化資料擷取。這能防止非預期的回應錯誤。

在程式碼中解析 JSON 字串。處理潛在的解析錯誤。JSON 模式提高了 API 整合的可靠性。它非常適合數據處理管線。

將 JSON 模式與系統提示詞結合。引導模型輸出特定的結構。這可確保格式一致。在使用之前驗證輸出，這有助於減少下游錯誤。

監控限制與錯誤

請遵守速率限制。每支金鑰每分鐘可發送 300 次請求。最多 8 個併發請求。請求主體大小限制為 8 MB。

監控 HTTP 狀態碼。429 表示超過速率限制。400 表示請求無效。500 表示伺服器錯誤。實施指數退避重試機制。這可防止壓垮 API。

追蹤最後一個串流區塊中的 token 用量。這有助於管理您的預付額度。錯誤不會消耗 token，從而保護您的餘額。定期監控可確保運作順暢。

計算成本和 token 用量

定價透明且預付。輸入 token 每百萬計費 $0.15。輸出 token 每百萬計費 $0.50。額度永不過期。無月費。

僅使用加密貨幣充值。僅接受 TRC20 上的 USDT 或 Base 上的 USDC。金額範圍為 $20 至 $500。較大充值可獲得贈送餘額。$50 起 +5%，$100 起 +10%，$200 起 +15%。

在大量使用前計算成本。估算您提示詞的代幣數量。這有助於有效預算。錯誤免費。不發還退款，但錯誤會被修正。使用儀表板追蹤支出。