Wu Shencha API 快速入门

基础配置

Wu Shencha API 提供标准的 OpenAI 兼容接口。你需要在代码中设置基础 URL 和 API 密钥。基础 URL 固定为 https://api.wushenchaapi.com/v1。模型 ID 为 uncensored，它是一个经过调优的开放权重模型，专为无审查场景设计，支持 lawful adult 内容。

密钥在注册后于“获取 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。这些限制确保了服务的稳定性。你可以随时生成新密钥以撤销旧密钥。