Wu Xianzhi API 快速开始指南
本文档介绍 Wu Xianzhi API 的快速接入流程,帮助你通过 OpenAI 兼容接口调用 uncensored 模型,实现无内容过滤的文本生成。
https://api.wuxianzhiapi.com/v1uncensored
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。上下文窗口为 100,000 Token(含提示词与回复)。错误代码包括:401 表示 Key 无效,402 表示余额不足,429 表示触发速率限制。模型对未成年人性内容保持硬性屏蔽,其他合法成人内容均无审查。获取模型列表可通过 GET /v1/models 完成。
接口能力与限制
所有限制、功能与价格一览。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 认证 | Authorization: Bearer YOUR_KEY |
| 模型 ID | uncensored |
| Base URL | https://api.wuxianzhiapi.com/v1 |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| JSON 模式 | response_format: {"type": "json_object"} |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 并发 | 每个密钥同时最多 8 个请求 |
| 请求大小 | 每次请求不超过 8 MB |
| 价格 | 输入 $0.15 / 百万 tokens · 输出 $0.50 / 百万 tokens |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 充值 | USDT(TRC20)或 USDC(Base),$20–$500 任意整数金额 |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10%,满 $200 送 15% |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
| 登录 | Google 或邮箱 + 密码 |
| 内容政策 | 允许成人内容;涉及未成年人的性内容一律拒绝 |
错误代码
错误以 JSON 返回,type 字段固定;失败或被拒绝的请求不计费。
| 状态码 | 类型 | 含义 |
|---|---|---|
400 | bad_request | JSON 无效、消息为空、参数错误或超出上下文窗口 |
401 | missing_key · invalid_key · key_revoked | 缺少密钥、密钥错误或已被新密钥替换 |
402 | no_credit | 余额不足——充值后立即恢复 |
403 | content_blocked | 涉及未成年人的性内容——拒绝且不计费 |
404 | not_found | 未知接口 |
413 | request_too_large | 请求体超过 8 MB |
429 | rate_limited · concurrency | 超过每分钟 300 次或 8 个并发——稍后重试 |
503 | upstream_busy | 模型繁忙——几秒后重试 |
常见问题
Wu Xianzhi AI 的模型是 GPT 或 Claude 吗?
不是。我们运行的是独立的开源权重模型,ID 为 uncensored。它经过专门调优,在合法成人内容上完全放开,不拒绝生成,与任何第三方厂商的模型无关。
预付费余额会过期吗?
不会。我们的 API 中转站采用按量计费模式,充值后获得的信用额度永久有效,没有月费或订阅费,适合长期部署。
是否支持工具调用?
支持。通过标准的 tools 参数,模型可以返回结构化的函数调用指令,方便开发者构建具有交互能力的 AI 应用。