Wu Xianzhi API 快速开始指南

API 基础端点与身份验证

Wu Xianzhi API 完全兼容 OpenAI 标准接口。所有请求均发送至 https://api.wuxianzhiapi.com/v1。你需要一个 API Key 来鉴权，将其放入请求头 Authorization: Bearer YOUR_API_KEY。注册后 Key 即刻生成，支持随时重新生成以作废旧 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 Key。模型 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 Key 限制为 300 请求/分钟，请求体最大 8 MB。上下文窗口为 64,000 Token（含提示词与回复）。错误代码包括：401 表示 Key 无效，402 表示余额不足，429 表示触发速率限制。模型对未成年人性内容保持硬性屏蔽，其他合法成人内容均无审查。获取模型列表可通过 GET /v1/models 完成。