无过滤 AI 聊天：分步集成指南

为什么无过滤 AI 聊天对开发者很重要

构建角色扮演应用的开发者经常面临导致用户体验沉浸感中断的静默拒绝。标准模型往往会降低内容质量，或基于模糊的“氛围”检查而非硬性政策违规来阻止请求。无过滤的 AI 聊天解决方案消除了这些任意守门人，使您的应用能够处理多样化、成熟或争议性话题，而无需持续摩擦。对于一致性比通用安全性更重要的内容管道而言，这种可靠性至关重要。

我们的基础设施专为服务成人和无限制内容请求而构建。我们不会因内容“NSFW”而降低你的流量优先级。相反，我们提供直达无限制模型的路径，该模型根据上下文而非隐藏的审核层来回答问题并生成故事。这种方法确保你的用户从专用聊天机器人中获得预期的原始、未经修饰的创造力。

设置您的环境

首先安装你首选语言的官方 OpenAI SDK，因为我们的 API 遵循标准的 chat-completions 协议。你需要配置环境变量以安全地存储 API 密钥。由于我们依赖现有的行业标准，设置过程非常简单。

使用你的包管理器安装库。对于 Python，使用 pip install openai。对于 Node.js，使用 npm install openai。安装完成后，导入客户端并使用你的基础 URL 初始化它。此步骤确保所有后续调用都正确路由到我们的服务器。保持密钥私密，除非使用代理，否则不要在客户端代码中暴露它。

配置基础 URL

将您的客户端指向 HTTPS://api.storyunfiltered.com/v1 以访问无审查端点。此基础 URL 替换 SDK 配置中的默认 OpenAI 端点。通过更改此单个变量，您将应用程序从标准 GPT 模型切换到我们的专用无审查大型语言模型。您必须在请求中指定的模型 ID 是 "uncensored"。此标识符告诉服务器将您的流量路由到哪个特定实例。

通过发送简单的测试请求来验证配置。检查 GET /v1/models 端点以确认模型是否可用。响应应列出 "uncensored" 为可用模型。此验证步骤确保在开始构建复杂功能之前，您的环境已正确连接。它还确认您生成的 API 密钥处于活动状态，并已链接到您的预付费余额。

使用您的 API 密钥进行认证

将 API 密钥作为 Bearer 令牌放入 Authorization 请求头中。我们支持通过 Google 登录或电子邮件和密码生成密钥。密钥在创建后立即显示，因此请将其复制到您的环境变量中。每个账户仅保留一个有效密钥；生成新密钥将立即替换旧密钥。这简化了密钥轮换流程，并降低了过期凭证滞留在系统中的风险。

注册无需手机号码，仅存储您的电子邮件以维护隐私。提示词不用于训练您的数据，这对于企业或注重隐私的应用至关重要。密钥不会过期，但与其关联的预付费信用额度也没有硬性过期日期。错误和拒绝不消耗您的余额，因此您可以自由测试而无需担心意外费用。

发送您的第一个请求

向 /v1/chat/completions 构造标准的 POST 请求，将模型设置为 "uncensored"。包含您的系统提示以定义角色，并添加用户消息以驱动对话。上下文窗口支持 100,000 个令牌，用于提示和补全的总和。这允许您传递大型文档或长对话历史而无需立即截断。确保您的负载保持在 8 MB 的请求体限制以内。

设置 temperature 和 top_p 参数以控制创造性。较高的 temperature 会产生更多样化的输出，非常适合角色扮演。较低的 temperature 可确保事实性或结构化任务的一致性。该模型通过 response_format 支持 JSON 模式，允许你为数据提取任务强制执行结构化输出。这种灵活性使 API 既适用于休闲聊天，也适用于生产级集成。

处理流式响应

通过在请求中将 stream 设置为 true 启用流式传输。API 返回服务器发送事件（SSE），包含生成的部分响应。这改善了终端用户的感知延迟，即使对于长输出，聊天也感觉灵敏。每个块包含增量内容，您的应用程序必须将其连接以形成最终响应。

流中的最后一个数据块包含令牌使用数据。使用此数据准确跟踪您的信用消耗。我们按每 1M 输入令牌 $0.15 和每 1M 输出令牌 $0.50 收费。计费基于实际使用情况，因此部分响应会按比例收费。这种透明度允许您在应用程序逻辑中直接实施成本控制。

实现工具调用

我们的 API 支持函数调用，使模型能够根据用户意图调用外部工具。在 tools 参数中定义您的函数，包括名称、描述和参数模式。如果模型确定需要函数，它将返回包含 tool_calls 的响应。然后您必须执行该函数并将结果在后续消息中发送回去。

此功能支持复杂的工作流，如天气查询、数据库查询或网页抓取。uncensored 模型以与标准模型相同的精度处理工具定义。但是，请注意，我们不提供嵌入或微调。如果您的应用依赖于向量搜索或自定义模型训练，此 API 可能不适合。坚持使用直接 chat-completions 可获得最佳结果。

优化成本与速度

通过最小化不必要的 API 调用来最大化预付费余额的效用。在测试期间使用 seed 参数以获得确定性输出。调整 max_tokens 限制以防止模型生成过长从而耗尽余额的回复。默认输出限制为 2,048 个 token，但您可以将其增加到每次请求 16,000 个 token。这对于在一次调用中生成长篇故事或详细报告非常有用。

监控您的请求速率以保持在每分钟 300 次请求的限制内。如果超出此限制，您将收到 429 错误。在客户端代码中实施指数退避以优雅地处理重试。由于错误是免费的，您可以无惩罚地重试失败的请求。这种安全网确保了即使在高峰使用期间也能保持可靠性。

排查常见错误

如果您收到 401 错误，请验证您的 API 密钥是否正确且有效。检查基础 URL 是否完全匹配 HTTPS://api.storyunfiltered.com/v1。404 错误通常表示端点路径有拼写错误。确保使用正确的 HTTP 方法，聊天补全使用的是 POST。如果错误持续存在，请从仪表板重新生成密钥。

429 错误表示您已超过每分钟 300 次请求的速率限制。等待窗口重置或降低请求频率。如果遇到 413 错误，表示您的请求体超过 8 MB 限制。简化您的负载或减小上下文窗口大小。这些错误是 REST API 的标准错误，可以通过仔细调试解决。