API 文件 & 快速入門

驗證與 Base URL

每個請求都以將您的客戶端指向 HTTPS://api.uncensoredia.com/v1 並附加您的金鑰。 授權 uses the standard Bearer 機制，因此您只需貼上透過 Google 或電子郵件註冊後收到的權杖。端點完全 openai compatible API 符合規範，意味著您只需在現有設定中更換 base URL 和 API 金鑰即可。您無需管理複雜的路由層或代理標頭。只需確保您的 Authorization header 包含您的唯一權杖。此設定可確保您的請求直接到達專屬的 uncensored 模型，且不會經過任何中介過濾。如果您收到 401 請驗證您的金鑰是否處於啟用狀態且格式正確。

聊天完成端點

發送訊息至 POST /v1/chat/completions 即時接收文字回應。此單一端點處理您所有的生成需求，從簡單提示到複雜的多輪對話。您可以使用參數如 max_tokens, temperature，以及 top_p. 模型支援龐大的 100,000 token 上下文視窗，允許您輸入大量文件或長對話歷史。您可以在回應中發送最多 16,000 個 token。如果您省略 max_tokens, 預設限制為 2,048 個 token。此端點不支持圖像或音頻生成。它是嚴格的文本輸入，文本輸出。使用以下 curl 命令立即測試您的連接。

Python SDK 集成

使用官方 OpenAI Python 程式庫以最小的程式碼變更與 API 互動。您只需覆寫 base_url 和 api_key 客戶端設定中。此方法確保您處理回應、錯誤和重試的現有邏輯保持完整。如果您啟用該功能，庫會自動處理 JSON 序列化和串流。此方法非常適合需要處理大量文字後端的服務或腳本。uncensored 模型會回應標準聊天完成請求，無需自訂解析邏輯。設定一次客戶端，即可在整個應用程式中使用。以下是初始化客戶端並發送基本請求的方法。

Node.js SDK 設置

使用 @anthropic-ai/sdk 或官方 openai 套件。設定 baseURL 至我們的端點並提供您的 API 金鑰。這讓您可以使用熟悉的方法，例如 chat.completions.create() 直接。SDK 為您處理 HTTP 請求並解析 JSON 回應。您可以輕鬆處理如 402 (信用額度不足) 或 429 應用邏輯中的「(rate limit)」。此設定非常適合 Web 伺服器、機器人或任何 Node.js 環境。無審查模型與標準請求格式無縫配合。配置您的客戶端以確保與 API 的預期相容。

串流回應

透過設定 stream: true 在您的請求中。API 返回伺服器發送事件 (SSE) 串流，讓您在文字生成時即時顯示。這改善了聊天介面的使用者體驗並降低了感知延遲。每個區塊包含部分回應，最後一個區塊包含 token 使用統計數據。您可以逐步處理這些區塊以組建完整回應。此功能對於需要即時回饋的應用程式至關重要。uncensored 模型支援所有請求類型的串流。處理串流事件以有效更新您的 UI。使用此程式碼在客戶端實現串流。

速率限制與上下文限制

API 實施嚴格限制以確保所有用戶的穩定效能。您可發送最多 每分鐘 300 次請求 每個金鑰並擁有 8 concurrent requests 隨時可用。最大請求主體大小為 8 MB。若超出這些限制，您將收到 429 狀態碼。請確保您透過指數退避機制處理重試，以避免反覆觸及這些限制。上下文視窗為 100,000 個令牌，但最大輸出為 16,000 個令牌。如果需要更多輸出，請調整 max_tokens 參數。錯誤如 401 (無效金鑰) 以及 402 (無信用額度) 是即時的，不會消耗您的 token 配額。請仔細管理您的配額，以避免在高量生成任務期間出現服務中斷。

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredia.com/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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredia.com/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);

串流

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)