快速入門指南

安裝與設定

客戶端僅需要您的 API 金鑰與正確的基礎 URL，即可將請求路由至我們的伺服器。此設定與任何標準的 OpenAI-compatible 客戶端都能配合。

配置環境變數或直接傳遞給客戶端建構子。您不需要管理複雜的路由邏輯或在多個模型之間切換。單一的 uncensored 模型會處理所有請求。

• 透過您的套件管理器安裝套件。
• 從您的儀表板取得 API 金鑰。
• 將客戶端指向 API 端點。

進行首次請求

向聊天補全端點發送 POST 請求，並將模型 ID 設為 "uncensored"。這會從模型直接返回文本回應，繞過標準內容篩選。您可以發送簡單提示或複雜的系統指令。

API 接受標準參數，如 temperature 和 top_p。使用以下 cURL 命令立即驗證連線和回應品質。

Copycurl https://api.chatbotunrestricted.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
  }'

此回應確認模型已啟動並準備好處理生產環境的流量。

處理串流回應

透過將 stream 參數設為 true 來啟用串流。API 會傳回伺服器發送事件（SSE）串流，隨著產生交付 token。這顯著降低了終端使用者的感知延遲。

解析 SSE 區塊以即時更新您的 UI。最後一個區塊包含請求的總 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)

確保您的客戶端能正確處理串流終止事件。

使用工具和函式呼叫

在請求中定義工具以讓模型輸出結構化資料。在 tools 陣列中傳遞工具定義，並指定 tool_choice 以進行自動選擇。模型會在回應內容中回傳函式呼叫。

解析函式參數並在您的程式碼中執行它們。然後，在後續訊息中將結果傳回模型。此循環允許在不依賴外部解析邏輯的情況下進行複雜的多步驟工作流程。

Copyimport OpenAI from "openai";

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

始終在執行之前驗證輸出架構。

管理令牌與限制

上下文視窗支援提示詞與補全合計 100,000 個 token。每個請求最多可輸出 16,000 個 token，若省略 max_tokens 則為 2,048。您可以透過回應中的 token 計數來監控您的使用量。

速率限制允許每分鐘 300 次請求，每金鑰 8 個併發請求。超出這些限制將觸發 429 錯誤。請確保每個帳戶使用獨一無二的金鑰，以避免共用限制。

錯誤如 401 表示無效金鑰，而 402 表示您需要更多積分。次要內容違規的拒絕是免費的，且不消耗 token。

錯誤處理與故障排除

在您的應用程式邏輯中優雅地處理 HTTP 錯誤。401 狀態表示您的 API 金鑰不正確或已過期。請檢查您的儀表板以確保金鑰處於活動狀態。

402 狀態表示預付額度不足。請使用 USDT 或 USDC 充值以恢復服務。429 錯誤表示您已達到速率限制。請等待並使用指數退避機制重試。

無效的請求主體會返回 400 錯誤。請驗證您的 JSON 結構是否符合 API 規範。這些錯誤是免費的，不會從您的餘額中扣除。

Python

Copyfrom openai import OpenAI

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