Uncensored AI API 的技术文档

基础 URL 和身份验证

基础 URL 是 https://api.unzensierteki.com/v1 und erfordert einen API-Schlüssel im Header Authorization: Bearer <KEY>. 注册后，您会通过 Google 或电子邮件在“获取 API 密钥”页面立即获得此密钥。每个账户仅保留一个活动密钥；新密钥将替换旧密钥。身份验证简单，适用于任何 OpenAI 兼容客户端。

Copycurl https://api.unzensierteki.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Rolle: du bist mein Assistent. Gib mir eine kurze Zusammenfassung."}]
  }'

有效的密钥允许访问所有端点。无效的密钥会引发 401 错误。如果连接失败，请检查您的密钥输入。

POST /v1/chat/completions：参数和结构

将提示发送到端点 /v1/chat/completions 使用模型 ID "uncensored"。此端点处理文本输入并生成文本输出，不对成年用户进行内容过滤。您可以设置参数如 temperature, top_p und stop 调整以控制模型行为。该模型对所有主题做出响应，只要它们合法。

Copyfrom openai import OpenAI

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

请求的结构遵循 OpenAI Chat-Completions 的标准。你也可以 presence_penalty und frequency_penalty nutzen, um die Wortwiederholung zu kontrollieren. Dies ist ideal für Rollenspiele und Textadventures.

SSE 流式传输与 Token 用量

通过 stream: true 设置。您将收到服务器发送事件（SSE），逐 Token 返回响应。最后一条响应包含令牌使用元数据，包括输入和输出令牌的数量。这允许在您的应用程序中实时显示响应。

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)

流式传输有助于降低最终用户的延迟。您可以立即处理 token，而无需等待完整响应。Token 统计信息有助于成本控制。

JSON 模式和 Function Calling

使用 response_format: {"type": "json_object"}, 以强制严格的 JSON 输出。这对于需要结构化数据的应用程序集成至关重要。您也可以 tools und tool_choice nutzen, um Funktionen aufzurufen. Das Modell unterstützt Tool-Calling für komplexe Workflows.

JSON 模式功能确保输出是可解析的。这避免了软件中的解析错误。Function Calling 极大地扩展了 API 的功能。

模型端点与令牌限制

端点 GET /v1/models 列出可用模型。"uncensored" 模型支持 100,000 个 token 的上下文窗口（输入加输出）。每个请求的最大输出为 16,000 个 token。如果 max_tokens 未设置时，最大输出为 2,048 个令牌。

这个大上下文窗口允许处理长文档。你可以维护长对话而不会丢失上下文连贯性。限制清晰且可预测。

限制、错误和成本控制

限制为每个密钥每分钟 300 次请求，最多 8 个并行请求。请求正文最大为 8 MB。401（密钥无效）、402（无余额）或 429（速率限制）等错误会为您提供反馈。失败的请求不会计费。

只有在成功使用 token 时才会消耗余额。429 错误表示您已达到限制。在再次尝试发送请求之前请稍等片刻。这有助于防止基础设施过载。

Node.js

Copyimport OpenAI from "openai";

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