uncensored.com LLM API 的分步集成

前提条件：SDK 与环境配置

安装你首选的语言 SDK 以与端点通信。大多数开发人员使用官方的 OpenAI SDK（用于 Python、Node.js 或 Go）。这是因为 API 遵循标准的 OpenAI 聊天补全模式。

确保您的环境已安装 Python 3.8+ 或 Node.js 18+。通过 pip 或 npm 安装包。您需要从仪表板获取 API 密钥。注册不需要电话号码。

• Python： pip install openai
• Node.js： npm install openai

将您的 API 密钥存储在环境变量中。这可以防止在版本控制中意外泄露。该密钥可访问 uncensored 模型。

配置基础 URL

将您的 SDK 客户端指向正确的基础 URL。这是成功集成的最关键步骤。默认的 OpenAI 基础 URL 不适用于此服务。

将基础 URL 设置为 HTTPS://api.uncensoredaicom.com/v1。这将请求定向到 uncensored LLM 基础设施。你必须发送的模型 ID 是 "uncensored"。这是一个针对最小拒绝率进行微调的开源权重模型。

通过调用模型端点来验证连接。这确认您的凭据和基础 URL 是否正确。成功的响应将返回模型 ID 和对象类型。

认证与请求头设置

将 API 密钥放入 Authorization 请求头中。所有请求均使用 Bearer 方案。此请求头用于验证您的预付费信用账户。

将标头设置为： Authorization: Bearer YOUR_API_KEY. 如果您将密钥传递给客户端构造函数，SDK 会自动处理此操作。请确保不包含多余的空格。无效密钥将返回 401 Unauthorized 错误。

每个账户拥有一个活跃密钥。生成新密钥会使前一个密钥失效。这简化了密钥轮换和安全管理。将密钥安全地保存在你的部署环境中。

发送标准聊天请求

向 /v1/chat/completions 发送 POST 请求。将消息作为角色和内容对象的数组发送。系统支持 user、assistant 和 system 角色。

示例结构： {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}API 返回文本补全。上下文窗口总共 100,000 个令牌。每次请求的最大输出为 16,000 个令牌。

错误和拒绝不消耗信用额。这保护您的预付余额。设置 temperature 和 top_p 以进行控制。默认值适用于大多数用例。

启用流式传输以实现实时输出

设置 stream: true 在您的请求正文中。这将激活服务器发送事件 (SSE)。Token 将增量到达，而无需等待完整输出。

解析 SSE 流以实时显示文本。最后一个数据块包含令牌用量统计信息。这有助于准确追踪计费。流式传输可降低终端用户的感知延迟。

优雅处理网络中断。如果流断开，请重新连接。uncensored API 支持稳定的流式传输。监控连接状态。用于聊天界面或长文本生成。

使用工具和函数调用

在请求体中定义工具。传递一个函数模式列表。模型可以根据用户意图调用这些函数。这实现了类似代理的行为。

指定 tool_choice 控制函数选择。使用 auto 用于自动检测。API 支持标准工具定义。从响应中解析函数调用参数。

在代码中实现函数执行。将结果作为消息发送。模型继续对话。这启用了复杂的工作流。测试确保参数解析准确。

处理 JSON 模式响应

设置 response_format: {"type": "json_object"}. 这强制模型输出有效的 JSON。用于结构化数据提取。它防止了响应格式错误。

在代码中解析 JSON 字符串。处理潜在的解析错误。JSON 模式提高了 API 集成的可靠性。它非常适合数据处理管道。

将 JSON 模式与系统提示结合使用。引导模型输出特定模式。这确保了格式的一致性。在使用前验证输出。这减少了下游错误。

监控限制与错误

遵守速率限制。您每密钥每分钟获得 300 次请求。最多 8 个并发请求。请求体大小限制为 8 MB。

监控 HTTP 状态代码。429 表示超出速率限制。400 表示请求错误。500 表示服务器错误。实施指数退避进行重试。这可以防止使 API 过载。

在最后一个流式数据块中追踪令牌使用情况。这有助于管理您的预存余额。错误不会消耗令牌，从而保护您的余额。定期监控可确保运行顺畅。

计算成本和令牌用量

定价透明且预付费。输入令牌每百万 $0.15。输出令牌每百万 $0.50。信用额永不失效。无月费。

仅使用加密货币充值。USDT (TRC20) 或 USDC (Base)。金额范围为 $20 至 $500。大额充值适用奖励余额。$50 起 +5%，$100 起 +10%，$200 起 +15%。

在大量使用之前计算成本。估算提示词的 token 数量。这有助于有效预算。错误免费。不退款，但错误会被修复。使用仪表板跟踪支出。