API 文档 & 快速入门

认证与基础 URL

每个请求都以将您的客户端指向 HTTPS://api.uncensoredia.com/v1 并附加你的密钥。 授权 使用标准 Bearer 方案，因此您只需粘贴通过 Google 或邮箱注册后收到的令牌。端点完全 openai compatible API 合规，意味着您只需在现有配置中交换 base URL 和 API 密钥。您无需管理复杂的路由层或代理头。只需确保您的 Authorization 包含您的唯一令牌。此设置确保您的请求直接到达专用的无审查模型，无需任何中间过滤。如果您收到 401 验证您的密钥是否有效且格式正确。

聊天完成端点

发送消息至 POST /v1/chat/completions 接收来自无审查模型的文本响应。此单一端点处理所有生成需求，从简单提示到复杂的多轮对话。你可以使用诸如 max_tokens, temperature，以及 top_p模型支持庞大的 100,000 token 上下文窗口，允许您输入大量文档或长对话历史。您可以在响应中发送多达 16,000 个 token。如果您省略 max_tokens, 默认限制为 2,048 个 token。此端点不支持图像或音频生成。它是严格的文本输入、文本输出。使用以下 curl 命令立即测试您的连接。

Python SDK 集成

使用官方 OpenAI Python 库以最小的代码更改与 API 交互。您只需覆盖 base_url 和 api_key 在客户端配置中。这种方法确保您处理响应、错误和重试的现有逻辑保持完整。如果您启用它，库会自动处理 JSON 序列化和流式传输。这种方法非常适合需要处理大量文本的后端服务或脚本。uncensored 模型响应标准的聊天完成请求，无需自定义解析逻辑。配置一次客户端，即可在整个应用程序中使用。以下是如何初始化客户端并发送基本请求。

Node.js SDK 设置

使用 @anthropic-ai/sdk 或官方 openai 包。设置 baseURL 指向我们的端点并提供您的 API 密钥。这使您可以使用熟悉的方法，例如 chat.completions.create() 直接。SDK 为您处理 HTTP 请求并解析 JSON 响应。您可以轻松处理如 402 (余额不足) 或 429 (速率限制) 在您的应用程序逻辑中。此设置非常适合 Web 服务器、机器人或任何 Node.js 环境。无审查模型与标准请求格式无缝兼容。配置您的客户端以确保与 API 期望的兼容性。

流式响应

通过设置启用实时 token 交付 stream: true 在您的请求中。API 返回服务器发送事件（SSE）流，允许您在生成文本时显示文本。这改善了聊天界面的用户体验并降低了感知延迟。每个块包含部分响应，最后一个块包含令牌使用统计信息。您可以增量处理这些块以构建完整的响应。此功能对于需要即时反馈的应用程序至关重要。uncensored 模型支持所有请求类型的流式传输。处理流事件以有效更新您的 UI。使用此代码在客户端实现流式传输。

速率限制与上下文限制

API 实施严格限制以确保所有用户的稳定性能。您可以发送最多 每分钟 300 次请求 每个密钥和拥有 8 concurrent requests 随时可用。最大请求体大小为 8 MB。如果超出这些限制，您将收到 429 状态码。确保您使用指数退避处理重试，以避免反复触及这些限制。上下文窗口为 100,000 个令牌，但最大输出为 16,000 个令牌。如果需要更多输出，请调整 max_tokens 参数。诸如 401 (密钥无效) 和 402 (无余额) 是即时的，不会消耗您的 token 配额。仔细管理您的配额，以避免在高容量生成任务期间服务中断。

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

流式传输

Copystream = 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)