快速入门指南

安装和配置

首先安装你所用语言的官方 SDK。客户端只需要你的 API 密钥和正确的基础 URL 即可将请求路由到我们的服务器。此设置适用于任何标准的 OpenAI 兼容客户端。

配置环境变量或直接将其传递给客户端构造函数。您无需管理复杂的路由逻辑或在多个模型之间切换。单一的 uncensored 模型处理所有请求。

• 通过你的包管理器安装该包。
• 从仪表板获取 API 密钥。
• 将客户端指向 API 端点。

发起首次请求

向聊天补全端点发送 POST 请求，并将模型 ID 设置为 "uncensored"。这将返回来自模型的直接文本响应，绕过标准内容过滤器。您可以发送简单提示或复杂的系统指令。

API 接受温度 (temperature) 和 top_p 等标准参数。使用以下 cURL 命令立即验证连接性和响应质量。

Copycurl https://api.chatbotunrestricted.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
  }'

此响应确认模型已激活并准备好处理生产流量。

处理流式响应

通过将 stream 参数设置为 true 启用流式传输。API 返回服务器发送事件 (SSE) 流，按生成顺序交付令牌。这显著降低了终端用户的感知延迟。

解析 SSE 块以实时更新您的 UI。最后一个块包括请求的总令牌使用情况。这种方法对于期望即时反馈的聊天界面至关重要。

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)

确保您的客户端正确处理流终止事件。

使用工具和函数调用

在请求中定义工具以让模型输出结构化数据。在 tools 数组中传递工具定义，并指定 tool_choice 以实现自动选择。模型在响应内容中返回函数调用。

解析函数参数并在您的代码中执行它们。然后将结果传递给模型作为后续消息。此循环允许在不依赖外部解析逻辑的情况下实现复杂的多步工作流。

Copyimport OpenAI from "openai";

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

在执行之前始终验证输出模式。

管理令牌与限制

上下文窗口支持提示和补全合计 100,000 个 token。每个请求最多可输出 16,000 个 token，或者如果省略 max_tokens 则为 2,048。请通过响应中的 token 计数监控您的使用情况。

每个 API 密钥每分钟允许 300 次请求和 8 个并发请求。超出这些限制将触发 429 错误。保持每个账户的密钥唯一，以避免共享限制。

错误如 401 表示密钥无效，而 402 表示您需要更多余额。因轻微内容违规导致的拒绝是免费的，且不消耗令牌。

错误处理和故障排除

在应用程序逻辑中优雅地处理 HTTP 错误。401 状态表示您的 API 密钥不正确或已过期。检查您的仪表板以确保密钥有效。

402 状态表示预充值余额不足。使用 USDT 或 USDC 充值以恢复服务。429 错误表示您已达到速率限制。等待并重试，采用指数退避策略。

无效的请求体返回 400 错误。验证您的 JSON 结构是否与 API 规范匹配。这些错误是免费的，不会从您的余额中扣除。

Python

Copyfrom openai import OpenAI

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