API 參考與快速入門

身份驗證與基礎 URL

使用您的 API 金鑰搭配基礎 URL https://api.chatuncensored.cc/v1。將金鑰傳入 Authorization 作為 Bearer token 標頭。此設置適用於任何 OpenAI 相容 SDK 或客戶端。

在儀表板上透過 Google 或電子郵件產生金鑰。請妥善保管。您將獲得有效期為 7 天的 $0.50 額度。您可以先用此額度測試連線，再透過加密貨幣充值。

POST /v1/chat/completions

透過聊天補全端點將文字傳送至模型。將模型 ID 指定為 uncensored. 此開放權重模型對合法成人內容的回應沒有拒絕。

包含您的系統提示詞以引導行為。設置用戶訊息以輸入您的查詢。API 直接返回文本輸出。

配置 temperature 或 top_p 等參數以獲得多樣化的結果。模型可處理總計 100,000 token 的上下文。

錯誤如拒絕或網路問題不會消耗積分。您僅為成功的 token 生成付費。

Python SDK 使用方式

安裝官方 OpenAI Python 函式庫。將基礎 URL 設定為指向我們的 API。在環境或客戶端中設定 API 金鑰。

建立用戶端實例。呼叫 chat.completions.create 並提供模型與訊息。從回應物件中取得助理的回覆。

處理速率限制或無效金鑰的例外情況。SDK 簡化了 JSON 解析和請求格式化。

先使用試用信用額進行測試。在擴展使用之前，驗證回應結構是否符合預期。

Node SDK 整合

匯入 OpenAI Node 套件。使用您的基礎 URL 和金鑰初始化客戶端。將模型定義為 uncensored.

呼叫補全方法並傳入您的訊息陣列。等待回應以取得生成的文字。這與非同步函式無縫配合。

透過設定 response_format 以 {"type": "json_object"}. 確保您的輸出為有效的 JSON，以便程式化使用。

透過回應中的 Token 監控用量。追蹤輸入與輸出數量，以有效管理您的預付額度。

串流、工具與 JSON 模式

在請求主體中將 stream 設為 true。透過伺服器發送事件接收區塊。隨著每個 token 到達進行處理，以實現低延遲。

支援函式呼叫、工具與 tool_choice。定義外部 API 的 Schema。模型會回傳結構化的參數以供執行。

使用 JSON 模式進行嚴格輸出格式。設定 response_format 以確保有效的 JSON 回應。這能減少自動化管線中的解析錯誤。

將串流傳輸與工具結合，實現互動體驗。逐 token 更新 UI。透過即時生成保持用戶參與。

速率限制與錯誤代碼

預期每支金鑰每分鐘 300 次請求。限制並行請求為 8 個。請求主體大小必須低於 8 MB。

透過驗證您的 API 金鑰來處理 401 錯誤。檢查是否有拼寫錯誤或金鑰已過期。如有必要請重新生成。

額度耗盡時返回 402。使用 USDT 或 USDC 充值。額度永不過期。$200 存款可獲 +15% 贈金。

遇到 429 速率限制。實施指數退避。在指定延遲後重試。監控使用情況以避免中斷。

cURL

Copycurl https://api.chatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set user role to beta tester for the new chat interface"}]
  }'

Python

Copyfrom openai import OpenAI

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