Wu Xianzhi API 快速開始指南

API 基礎端點與身份驗證

Wu Xianzhi API 完全相容 OpenAI 標準介面。所有請求均發送至 https://api.wuxianzhiapi.com/v1。你需要一個 API 金鑰來進行鑑權，將其放入請求標頭 Authorization: Bearer YOUR_API_KEY。註冊後金鑰即刻生成，支援隨時重新生成以作廢舊金鑰。我們採用預付費模式，信用額度永不過期，按量計費，無訂閱費。

發送第一個請求

使用 curl 可以直接驗證 API 連通性。發送 POST 請求到 /v1/chat/completions，指定模型 ID 為 uncensored。該模型為獨立運行的開放權重模型，針對合法成人內容及爭議話題進行了去審查優化，不拒絕生成內容。

確保請求體包含 messages 陣列。如果鑑權失敗會返回 401，餘額不足返回 402。

复制curl https://api.wuxianzhiapi.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 庫即可。只需修改 base_url 指向我們的伺服器，並傳入正確的 API 金鑰。模型 ID 固定為 uncensored。注意，我們僅支援文本生成，不提供嵌入向量或多模態能力。此方式適合後端服務整合，能輕鬆處理結構化資料互動。

复制from openai import OpenAI

client = OpenAI(base_url="https://api.wuxianzhiapi.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.js SDK 整合

Node.js 開發者同樣可以利用 openai npm 套件進行整合。配置 baseURL 和 apiKey 後，呼叫邏輯與 OpenAI 一致。該 uncensored LLM API 支援工具呼叫，你可以透過 tools 參數定義函數，模型將返回結構化 JSON 供你執行。這使其成為建構不受限 AI 應用程式的理想後端。

复制import OpenAI from "openai";

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

串流響應 (SSE)

為了降低首字延遲，建議在請求中設定 stream: true。API 將透過伺服器發送事件 (SSE) 返回分塊響應。這對於即時對話或長文本生成場景至關重要。客戶端需監聽 data 事件並解析 JSON 區塊，拼接最終內容。串流傳輸不改變計費方式，仍按輸入輸出 Token 總數計算。

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

限制、錯誤處理與上下文視窗

每個 API 金鑰限制為 300 請求/分鐘，請求體最大 8 MB。上下文視窗為 100,000 Token（含提示詞與回覆）。錯誤代碼包括：401 表示 Key 無效，402 表示餘額不足，429 表示觸發速率限制。模型對未成年人性內容保持硬性屏蔽，其他合法成人內容均無審查。獲取模型列表可透過 GET /v1/models 完成。