如何整合 Uncensored AI API

為什麼選擇 Uncensored AI API？

大多數商業 LLM 供應商實施嚴格的內容篩選器，可能會阻止創意寫作、角色扮演或對爭議性主題的技術分析。無審查 AI API 移除了這些任意拒絕，讓模型根據其訓練數據而非內容政策層來回答。這對於需要原始模型輸出且無需後置篩選器的應用程式開發者特別有用。

與將請求路由到多個供應商的模型聚合器不同，此服務提供單一專屬模型。這消除了路由邏輯的不確定性，並確保請求之間行為的一致性。該模型是一種開放權重模型，經過微調以最大限度地減少對合法成人內容、安全研究和虛構敘事的拒絕。

然而，「無審查」並不意味著無限制。服務仍對涉及未成年人的性內容實施硬性限制。對於大多數其他用例，包括成熟主題或非傳統邏輯，模型都會生成回應。這種方法非常適合希望完全控制應用程式內容策略而不依賴供應商品味的開發者。

設定您的環境

整合從將您的 OpenAI 相容 SDK 指向正確的基礎 URL 開始。端點位於 https://api.uncensoredai.top/v1。這表示您可以使用官方的 OpenAI Python 或 Node.js 函式庫，而無需重寫客戶端邏輯。您只需更新 base_url 參數並提供您的 API 金鑰即可。

服務支援 100,000 token 的上下文視窗，遠大於許多標準方案。這允許處理龐大的提示詞歷史或大型文件處理。請注意，每次請求的最大輸出為 32,000 token。若未指定 max_tokens，預設值為 2,048 token。

• SDK 相容性： 適用於任何支援 OpenAI Chat Completions 協議的客戶端。
• 上下文視窗：總計 100,000 token（輸入 + 輸出）。
• 最大輸出：每個請求 32,000 token。

請確保環境變數設定正確以避免延遲問題。此 API 專為直接程式碼整合而設計，因此沒有需要學習的網頁介面。你純粹透過 HTTP 請求與其互動。

身份驗證與標頭

身份驗證透過標準 Authorization 標頭處理。註冊後你會收到一個 API 金鑰。與為每個帳戶發出多個金鑰的服務不同，此平台強制每個帳戶只有一個有效金鑰。如果你生成新金鑰，舊金鑰會立即失效。

要對請求進行身份驗證，請包含標頭：Authorization: Bearer YOUR_API_KEY。該服務還提供 GET /v1/models 端點，返回可用的模型資訊，包括模型 ID uncensored。這在發送複雜負載之前驗證連線時很有用。

速率限制：

• 每個金鑰每分鐘 300 次請求。
• 每個金鑰同時 8 次並行請求。
• 最大請求主體大小 8 MB。

這些限制對大多數應用程式來說已相當寬鬆，但應予以遵守以避免 429 錯誤。由於沒有訂閱層級，這些限制適用於所有使用者，與預付額度餘額無關。

發送您的第一個完成請求

基本請求遵循標準的 Chat Completions 格式。你傳送包含 model 設為 uncensored 以及 messages 陣列的 JSON 資料。服務會回傳文字回應。沒有嵌入、視覺或音訊端點——這是純文字 API。

請求範例：

以下示範標準聊天完成請求。將 YOUR_API_KEY 替換為你的實際金鑰。

Copycurl https://api.uncensoredai.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

回應將包含在 choices[0].message.content 中生成的文本。錯誤以標準 HTTP 格式返回，允許你優雅地處理重試或失敗。請注意，錯誤不會消耗你的額度，因此你可以自由測試。

對於熟悉 OpenAI 的開發者來說，體驗是一樣的。唯一的區別是基礎 URL 和模型在內容篩選方面的行為。這種一致性降低了已經使用 OpenAI 相容工具的團隊的學習曲線。

處理串流輸出回應

支援透過伺服器發送事件（SSE）進行串流輸出。這允許你在 token 生成時接收它們，為長回應提供更好的使用者體驗。串流端點與非串流端點相同；你只需在請求中設定 stream: true。

串流輸出優點：

• 降低使用者的感知延遲。
• 能夠即時顯示部分結果。
• 隨著 token 增量處理，有效利用記憶體。

串流回應的最後一個區塊包含 token 使用統計。這對於計費準確性至關重要，因為你可以精確追蹤消耗了多少 token。串流期間的錯誤可能導致部分回應，因此你的客戶端程式庫應優雅地處理不完整的區塊。

程式碼範例：

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredai.top/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

確保你的客戶端庫正確處理 SSE 串流。大多數現代 SDK 會抽象化這一點，但了解底層協議有助於調試連線問題或解析錯誤。

進階功能：JSON 模式與工具

API 支援透過將 response_format 設為 {"type": "json_object"} 來實現結構化輸出。這會強制模型返回有效的 JSON，對於與其他軟體系統整合至關重要。此功能對於資料提取或生成設定檔特別有用。

也支援函式呼叫。你可以在請求中定義工具，模型會在回應中返回工具呼叫。這允許複雜的工作流程，其中 LLM 可以觸發外部動作。tool_choice 參數允許你強制使用特定工具或讓模型自行決定。

關鍵參數：

• temperature：控制隨機性。
• top_p：控制多樣性。
• stop：定義停止序列。
• seed：用於確定性回應。

這些功能使 API 適合需要可靠結構化資料的生產環境應用程式。雖然模型無審查，但它仍會遵循請求時的結構約束。這種自由與結構的平衡是開發複雜代理程式的開發者的一大優勢。

監控用量與限制

用量會按 API 金鑰追蹤。儀表板顯示你目前的預付額度餘額和最近的請求歷史。由於計費基於實際 token 用量，你可以即時監控成本。服務不對錯誤或拒絕收費，這可以在測試階段節省費用。

用量指標：

• 輸入 token：每 1M 個 token 收費 $0.25。
• 輸出 token：每 1M 個 token 收費 $1.00。
• 錯誤：免費。

如果你的客戶端程式庫支援，你可以設定警報，但主要的監控是透過帳戶儀表板進行。每分鐘 300 個請求的限制確保所有使用者的公平使用。如果你超過此限制，將收到 429 狀態碼。

對於高流量應用程式，建議在重試時實施指數退避。服務設計為可靠，但可能會發生網路問題或速率限制。追蹤你的 token 用量有助於你有效預算，特別是因為額度永不過期。

透過加密貨幣管理額度

付款僅透過加密貨幣處理。您可以使用 USDT (TRC20) 或 USDC (Base) 為帳戶儲值。最低儲值金額為 $10，最高為 $500。沒有月費或定期費用。

贈送額度：

• 儲值 50 美元：+5% 贈送額度。
• $100 儲值：贈送 10% 額外額度。

額度永不過期，因此您可以一次性儲值並隨時間使用。這非常適合 token 消耗量會變動的長期專案。由於沒有信用卡處理費用，對於已經持有穩定幣的開發者而言，加密貨幣是具成本效益的選擇。

付款流程：

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredai.top/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

要付款，請從你的儀表板產生存款地址，發送加密貨幣，額度就會自動加入。額度不可退款，但像重複扣款等錯誤會透過支援頁面修復。此模式降低了可能面臨銀行限制的全球開發者的摩擦。