Wu Shencha API 快速入門

基礎設定

Wu Shencha API 提供標準的 OpenAI 相容介面。你需要在程式碼中設定基礎 URL 和 API 金鑰。基礎 URL 固定為 https://api.wushenchaapi.com/v1。模型 ID 為 uncensored，它是一個經過微調的開放權重模型，專為無審查場景設計，支援合法成人內容。

金鑰在註冊後於「取得 API 金鑰」頁面顯示。由於 API 是 OpenAI 相容的，你可以直接修改官方 SDK 的 base_url 參數即可接入。無需額外的路由設定或複雜設定。

聊天補全介面

使用 POST /v1/chat/completions 端點發送文字請求。該介面接受標準訊息格式，回傳生成的文字內容。這是最基本的互動方式，適用於大多數文字生成場景。

請求體需包含 model、messages 等欄位。確保你的請求體大小不超過 8 MB。如果金鑰無效或餘額不足，API 會回傳相對應的錯誤碼。

复制curl https://api.wushenchaapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK

對於 Python 開發者，可以使用官方 openai SDK。只需將 base_url 指向 Wu Shencha API 的端點，並傳入你的 API 金鑰。這種方法保持了與 OpenAI 原生程式碼的一致性，便於遷移。

確保安裝最新版本的 SDK。程式碼範例展示了如何初始化客戶端並發送訊息。這種方式簡潔高效，適合快速原型開發。

复制from openai import OpenAI

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

Node SDK

Node.js 開發者同樣可以使用 openai npm 套件進行連線。設定方式與 Python 類似，設定 baseURL 和 apiKey。這確保了跨語言的一致性，減少了學習成本。

支援非同步請求和錯誤處理。你可以輕鬆整合到現有的 Node.js 應用程式中。注意處理非同步回呼或 Promise 以避免阻塞。

复制import OpenAI from "openai";

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

串流輸出

支援透過 Server-Sent Events (SSE) 進行串流輸出。設定 stream: true 參數，API 將逐塊回傳回應資料。這對於即時應用或長文字生成非常有用，可以提供更低的延遲體驗。

串流回應不會改變模型的行為，只是改變了資料傳輸的方式。你可以按需選擇串流或非串流模式。

复制stream = 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)

限制與配額

每分鐘最多 300 次請求。上下文視窗為 100,000 個 token（包含提示詞和補全）。如果超出限制，API 回傳 429 錯誤。金鑰無效時回傳 401，餘額不足時回傳 402。

預付額度永不過期，無月租費。每次請求的體大小限制為 8 MB。這些限制確保了服務的穩定性。你可以隨時產生新金鑰以撤銷舊金鑰。