API 文件

身份驗證與基礎 URL

API 需要單一 API 金鑰進行驗證。使用 Google 或電子郵件地址註冊後，您將立即收到此金鑰。將其傳遞至 Authorization 作為 Bearer token 標頭。基礎 URL 為 https://api.topuncensored.com/v1. 此 URL 適用於任何 OpenAI 相容的 SDK 或函式庫。

• 使用標頭： Authorization: Bearer YOUR_API_KEY
• 將您的客戶端基礎 URL 設定為提供的端點。

此設定確保您可以在不更改核心邏輯的情況下交換程式庫。

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

聊天完成端點

將文字提示发送至 /v1/chat/completions 端點。模型 ID 為 uncensored. 此端點處理標準聊天格式與訊息。它直接返回文字回應。沒有額外的層級或封裝。您可以控制 100,000 token 的上下文視窗。請求小於 8 MB 時運作可靠。用於直接文字生成。

使用 system 提示和 user 消息構造您的請求。模型在不過濾合法成人內容的情況下回應。缺少鍵等錯誤返回 401。信用額用盡？您會收到 402 錯誤。這些是清晰的信號。

串流回應

在請求主體中將 stream: true. 您會收到即時生成的文字區塊。這降低了長輸出時的感知延遲。最後一個區塊包含 token 使用數據。可用於即時顯示或漸進式渲染。這對於高流量應用程式非常高效。

解析每個區塊以構建最終回應。此方法能優雅地處理大型輸出。API 支援標準的 Server-Sent Events。這是互動式應用程式的推薦方法。

Copyfrom openai import OpenAI

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

工具調用與 JSON 模式

使用函式呼叫進行結構化互動。在你的請求中定義工具。模型返回結構化參數。設定 response_format 以 {"type": "json_object"} 用於嚴格的 JSON 輸出。這可確保可預測的資料格式。結合這些功能以建立強大的整合。您可以精確控制輸出結構。

工具調用使用標準的 OpenAI 模式。JSON 模式強制使用有效的 JSON。將這些用於 API 集成或數據提取。這種靈活性支持複雜的工作流程。

Copyimport OpenAI from "openai";

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

參數與限制

調整 temperature, top_p，以及 stop 序列。設定 max_tokens 至 16,000。若省略則預設為 2,048。使用 presence_penalty 和 frequency_penalty. 使用 seed 用於確定性輸出。這些參數微調生成品質。您可以完全控制輸出風格。

每分鐘的速率限制為 300 次請求。同時請求上限為 8 個。這些限制確保穩定的效能。請透過儀表板監控您的使用量。調整參數以優化您的特定使用案例。

錯誤與上下文視窗

優雅地處理錯誤。401 表示無效。402 表示信用額度不足。429 表示速率限制。上下文窗口總共為 100,000 個 token。輸出最大為 16,000 個 token。明智地管理您的 token。錯誤不消耗信用額度。這在調試期間節省資金。使用最後一個數據塊獲取使用統計信息。

追蹤您的 token 使用量。避免觸及速率限制。使用指數退避進行重試。這確保了可靠的運行。API 旨在具有強大的健壯性。將錯誤處理作為正常流程的一部分。

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)