API 参考与快速入门

认证和基础 URL

使用您的 API 密钥与基础 URL https://api.chatuncensored.cc/v1。将密钥放在 Authorization 页眉作为 Bearer 令牌。此设置适用于任何 OpenAI 兼容的 SDK 或客户端。

在仪表板上通过 Google 或邮箱生成密钥。请妥善保管。您将获得有效期为 7 天的 $0.50 额度。您可以此测试连通性，然后再通过加密货币充值。

POST /v1/chat/completions

将文本发送至模型，使用 uncensored. 该开源模型对合法的成人内容以无拒绝的方式进行响应。

包含 system prompt 以引导行为。设置包含您查询的 user 消息。API 直接返回文本输出。

配置 temperature 或 top_p 等参数以获得多样化结果。模型支持高达 100,000 token 的组合上下文。

错误如拒绝或网络问题不会消耗信用额度。您只为成功的令牌生成付费。

Python SDK 使用

安装官方 OpenAI Python 库。将基础 URL 配置为指向我们的 API。在环境变量或客户端中设置 API 密钥。

创建客户端实例。调用 chat.completions.create 方法，传入模型和消息。从响应对象中获取助手的回复。

处理速率限制或无效密钥的异常。SDK 简化了 JSON 解析和请求格式化。

首先使用试用额度进行测试。在扩大使用量之前，验证响应结构是否符合预期。

Node SDK 集成

导入 OpenAI Node 包。使用你的基础 URL 和密钥初始化客户端。将模型定义为 uncensored.

调用补全方法并传入您的消息数组。等待响应以获取生成的文本。这与异步函数无缝配合。

通过设置 response_format 到 {"type": "json_object"}. 确保您的输出对于程序化使用是有效的 JSON。

通过响应令牌监控用量。跟踪输入和输出计数，以有效管理您的预付费余额。

流式传输、工具和 JSON 模式

通过将 stream 设置为 true。通过服务器发送的事件接收块。处理每个到达的令牌以实现低延迟。

支持函数调用、工具和 tool_choice。定义外部 API 的 schema。模型返回用于执行的结构化参数。

使用 JSON 模式进行严格的输出格式。设置 response_format 以确保有效的 JSON 响应。这减少了自动化管道中的解析错误。

将流式传输与工具结合使用以提供交互体验。逐 token 更新 UI。通过实时生成保持用户参与度。

速率限制与错误代码

预计每分钟每 key 300 次请求。限制并发请求数为 8。请求体大小必须保持在 8 MB 以下。

通过验证您的 API 密钥来处理 401 错误。检查是否有拼写错误或密钥已过期。如有必要，请重新生成。

余额耗尽时返回 402。使用 USDT 或 USDC 充值。额度永不过期。充值 $200 可额外获得 +15% 奖励。

遇到 429 速率限制。实现指数退避。在指定延迟后重试。监控使用情况以避免中断。

cURL

Copycurl https://api.chatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set user role to beta tester for the new chat interface"}]
  }'

Python

Copyfrom openai import OpenAI

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