API 文档

认证和基础 URL

API 需要单个 API 密钥进行身份验证。使用 Google 或电子邮件地址注册后，您将立即获得此密钥。将其传递到 Authorization 页眉作为 Bearer 令牌。基础 URL 为 https://api.topuncensored.com/v1. 此 URL 适用于任何 OpenAI 兼容的 SDK 或客户端库。

• 使用标头： Authorization: Bearer YOUR_API_KEY
• 将您的客户端 base URL 设置为提供的端点。

此配置确保您可以更换库而无需更改核心逻辑。

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

聊天完成端点

向 /v1/chat/completions 端点。模型 ID 是 uncensored. 此端点处理带有消息的标准聊天格式。它直接返回文本响应。没有额外的层或包装器。您可以控制 100,000 个 token 的上下文窗口。请求小于 8 MB 时工作可靠。用于直接文本生成。

使用 system 提示和 user 消息构建您的请求。模型在不过滤合法成人内容的情况下响应。缺少键等错误返回 401。积分用完？你会收到 402 错误。这些是清晰的信号。

流式响应

通过将 stream: true. 您会收到生成的文本块。这降低了长输出的感知延迟。最后一个数据块包括 Token 使用数据。可用于实时显示或渐进式渲染。这对于高容量应用非常高效。

解析每个数据块以构建最终响应。此方法优雅地处理大输出。API 支持标准的服务器发送事件 (SSE)。这是交互式应用程序的推荐方法。

Copyfrom openai import OpenAI

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

工具调用与JSON模式

使用函数调用进行结构化交互。在你的请求中定义工具。模型返回结构化参数。设置 response_format 到 {"type": "json_object"} 以确保严格的 JSON 输出。这确保了可预测的数据格式。结合这些功能可实现稳健的集成。您可以精确控制输出结构。

工具调用遵循标准的OpenAI模式。JSON模式强制生成有效的JSON。将这些用于API集成或数据提取。这种灵活性支持复杂的工作流程。

Copyimport OpenAI from "openai";

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

参数和限制

调整 temperature, top_p，以及 stop 序列。设置 max_tokens to 16,000. Default is 2,048 if omitted. Control repetition with presence_penalty 和 frequency_penalty. 使用 seed 用于确定性输出。这些参数可微调生成质量。您可以完全控制输出风格。

频率限制为每分钟 300 次请求。并发请求上限为 8 个。这些限制确保稳定的性能。通过仪表板监控您的使用情况。调整参数以优化您的特定用例。

错误与上下文窗口

优雅地处理错误。401 表示密钥无效。402 表示信用额度不足。429 表示速率限制。上下文窗口总共为 100,000 个令牌。输出最大为 16,000 个令牌。明智地管理您的令牌。错误不消耗信用额度。这在调试期间节省资金。使用最后一个数据块获取使用统计信息。

跟踪您的 token 使用情况。避免触及速率限制。使用指数退避进行重试。这确保了可靠的运行。API 旨在具备鲁棒性。将错误处理作为正常流程的一部分。

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)