Uncensored AI API 技術文件

基礎 URL 與身份驗證

基礎 URL 是 https://api.unzensierteki.com/v1 und erfordert einen API-Schlüssel im Header Authorization: Bearer <KEY>. 註冊後，您會立即透過 Google 或電子郵件在「取得 API 金鑰」頁面收到此金鑰。每個帳戶僅保留一個有效金鑰；新金鑰將取代舊金鑰。驗證簡單易行，適用於任何 OpenAI 相容的客戶端。

Copycurl https://api.unzensierteki.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Rolle: du bist mein Assistent. Gib mir eine kurze Zusammenfassung."}]
  }'

有效的金鑰允許訪問所有端點。無效的金鑰會觸發 401 錯誤。如果連接失敗，請檢查您的金鑰輸入。

POST /v1/chat/completions：參數與結構

將您的提示詞發送至端點 /v1/chat/completions 使用模型 ID "uncensored"。此端點處理文字輸入並為成人用戶生成無內容過濾的文字輸出。您可以設定參數如 temperature, top_p und stop 調整以控制模型行為。該模型會回應所有主題，只要它們是合法的。

Copyfrom openai import OpenAI

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

請求結構遵循 OpenAI Chat-Completions 的標準。您也可以 presence_penalty und frequency_penalty 用於控制詞語重複。這非常適合角色扮演和文字冒險遊戲。

透過 SSE 串流與 Token 用量

啟用串流功能，請 stream: true 設定。您將收到伺服器發送的事件（SSE），以逐 token 的方式回傳資料。最後的回應包含 token 使用量的中繼資料，包括輸入和輸出 token 的數量。這讓您可以即時在應用程式中顯示回應。

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)

串流傳輸有助於降低最終使用者的延遲。您可以立即處理 token，無需等待完整回應。Token 統計數據有助於成本控管。

JSON 模式與 Function Calling

使用 response_format: {"type": "json_object"}, 強制輸出嚴格 JSON。這對於需要結構化資料的應用程式整合至關重要。您也可以 tools und tool_choice 用於呼叫功能。該模型支援工具呼叫（Tool-Calling）以處理複雜的工作流程。

JSON 模式功能確保輸出可解析。這避免了軟體中的解析錯誤。Function Calling 大幅擴展了 API 的功能。

模型端點與 Token 限制

端點 GET /v1/models 列出可用模型。"uncensored" 模型支援 100,000 tokens 的上下文視窗（輸入加輸出）。每筆請求的最大輸出為 16,000 tokens。如果 max_tokens 未設定時，最大輸出為 2,048 tokens。

這個大上下文視窗允許處理長文件。你可以維護長對話而不損失上下文忠實度。限制清晰且可預測。

限制、錯誤與成本控管

限制為每分鐘每金鑰 300 次請求，最多 8 個並行請求。請求主體最大為 8 MB。錯誤如 401（金鑰無效）、402（無餘額）或 429（速率限制）會提供反饋。錯誤的請求不會計費。

僅在成功使用 token 時消耗餘額。429 錯誤表示您已達到限制。請稍等片刻再嘗試發送請求。這可防止基礎設施過載。

Node.js

Copyimport OpenAI from "openai";

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