API 文件 & 快速入門

基礎 URL 與驗證

開始將基礎 URL 設定為 HTTPS://api.uncensoredal.com/v1，並將 API 金鑰傳遞至 Authorization 標頭。每個帳戶提供一個有效金鑰，產生新金鑰會立即使舊金鑰失效。此簡單設定可與任何標準 OpenAI 相容客戶端配合使用，無需複雜的路由邏輯。

Copycurl https://api.uncensoredal.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate the next 50 lines of a python script"}]
  }'

此端點專用於聊天補全，因此您無需管理模型路由。每個請求都必須包含模型識別碼 "uncensored"，以確保連接到正確的推論伺服器。若金鑰遺漏或無效，身份驗證失敗將返回 401 狀態碼。

聊天完成端點

向 /v1/chat/completions 發送 POST 請求，將您的對話歷史包含在 messages 陣列中。系統處理文本輸入並回傳生成的文本，對於合法成人用途不會進行內容拒絕。您必須在載入內容中指定模型為 "uncensored" 以確保相容性。

Copyfrom openai import OpenAI

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

請求根據實際 token 使用情況計費，錯誤和拒絕則免費。這種預付模式意味著您只需為實際消耗的內容付費。端點支援標準參數，如 temperature 和 top_p，用於控制輸出的隨機性。

帶有 SSE 的串流回應

在請求主體中將 stream 設為 true，即可透過伺服器發送事件接收令牌。每個區塊包含令牌用量統計數據（位於最後一個區塊），讓您可以即時追蹤成本。這種方法可降低長生成過程的感知延遲。

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)

在構建需要即時顯示生成文字的聊天介面時使用串流。API 回傳標準的 OpenAI 相容串流事件，使其易於與現有 UI 函式庫整合。如果使用者更改輸入，您可以提前終止串流。

函式呼叫與 JSON 模式

在請求中定義工具以啟用函式呼叫，或使用 response_format 強制輸出 JSON。API 支援 tool_choice 以精確控制模型何時應呼叫函式。此功能與標準 OpenAI 架構相容，因此您可以重複使用現有的工具定義。

Copyimport OpenAI from "openai";

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

JSON 模式可確保輸出為有效的 JSON，這有助於程式化解析結構化資料。您可以結合溫度設定，在創意與結構可靠性之間取得平衡。API 透過回傳函式呼叫詳細資訊供您程式碼處理來處理工具執行邏輯。

模型參數配置

配置 temperature、top_p、stop 序列和 seed 等參數以控制生成行為。上下文窗口支持 100,000 token（提示與補全合計）。每次請求的最大輸出限制為 16,000 token，若您未指定 max_tokens，則限制為 2,048 token。

您可以使用 presence_penalty 和 frequency_penalty 來減少長文本中的重複。這些參數允許在不改變基礎權重的情況下微調模型的風格。逐步調整它們，以找到適合您特定用例的最佳平衡點。

限制、錯誤與上下文

速率限制設為每分鐘 300 次請求，每個金鑰最多支援 8 個同時請求。請求主體上限為 8 MB，因此必須謹慎管理大型上下文視窗。錯誤代碼包括：401 表示金鑰無效，402 表示信用額度不足，429 表示達到速率限制。

信用永不過期，因此您可以在爆發期之間暫停使用而不會損失資金。如果您達到並發限制，請使用指數退避重試。100,000 token 的上下文視窗允許大量的歷史記錄，但請注意輸出限制以避免截斷。