Uncensored API 常见问题

基础概念

用一句话介绍 Uncensored API 是什么？

这是一个付费的、仅文本的聊天补全接口，服务于单一模型，id 为 uncensored，不拒绝合法的成人内容、小说或争议性主题。

我调用哪个 URL？

使用 https://api.uncensoredapis.com/v1 作为基础地址。聊天请求发送至 POST /v1/chat/completions，模型列表位于 GET /v1/models。任何其他路径返回 404。

我需要学习新的 SDK 吗？

不需要。请求和响应格式遵循通用的聊天补全规范，因此官方 Python 和 Node 包只需更改基础 URL 和密钥即可使用。plain curl 也可用，如 文档所示。

有没有办法在付费前试用？

是的。新账户会获得 $0.50 的免费试用额度，有效期 7 天，注册时不需要提供支付信息。在 密钥页面 使用电子邮件和密码注册，密钥会立即显示。

我可以在多个模型之间选择吗？

不可以。只有一个模型，其 id 为 uncensored。调用模型路由将返回该单一条目，因此无需选择或切换。

该服务面向谁？

面向为成人构建产品的开发者，包括小说工具、角色扮演应用和研究助手。你负责在你发布的产品之上进行自己的年龄检查和内容规则制定。

密钥与访问

一个账户可以获得多少密钥？

一个。如果需要新值，请从账户重新生成；旧密钥将同时失效，因此请立即部署替换密钥。

密钥应该放在哪里？

将其保存在受控服务器的环境变量或密钥管理器中。浏览器 JavaScript 和移动二进制文件可被检查，因此请通过你自己的后端路由客户端流量，而不是嵌入密钥。

密钥如何发送？

在每个请求的 Authorization: Bearer 头中。缺少或错误的值将返回 401 及 JSON 错误对象。

我想要一个用于团队的无审查 API 密钥。我们可以共享一个吗？

可以，但每个进程共享相同的每分钟 300 个请求限制和相同的余额。在密钥前放置一个小网关，让每个队友访问网关而不是密钥本身。

限制与定价

提示词最大可以多大？

上下文窗口为 100,000 token，由提示词和补全共享。单个请求的体不得超过 8 MB。如果提示词加上 max_tokens 超过窗口，请求将被 400 拒绝。

回复可以有多长？

默认为 2048 token。你可以将 max_tokens 提高到每个请求最多 32,000。当答案因限制而停止时，finish_reason 读取为 length。

费用是多少？

输入 token 为每百万 $0.25，输出 token 为每百万 $1.00。余额为预付，无订阅，且余额永不过期。请参阅 定价页面查看表格。

能提供一个快速估算吗？

假设一个聊天轮次包含 1,500 个提示词 token 和 300 个补全 token，仅作为说明。输入费用为 $0.000375，输出费用为 $0.0003，即每轮约 $0.000675，因此 $1 可购买约 1,480 个此类轮次。

当我发送太多请求时会发生什么？

每个密钥每分钟最多发出 300 个请求。超出后你会收到 429，正确的响应是减慢速度并延迟重试。

集成问题

我可以设置哪些采样参数？

temperature、top_p 和 stop 等标准参数会透传给生成过程。在请求体中按常规方式设置即可。

API 会为我记住之前的对话轮次吗？

不会。每个请求都是独立的，因此每次都需要在 messages 中重新发送整个对话。当总 token 数接近 100,000 的上下文窗口限制时，请截去最早的轮次。

我可以向浏览器流式输出 token 吗？

是的，发送 stream: true 并读取服务器发送的事件。从后端执行此操作并将文本中继到页面，这样密钥永远不会到达客户端。

支持 system 消息吗？

支持。在数组中第一个位置放置 role 为 system 的消息，以设定对话的基调、格式和边界。

当输出被截断时，我应该首先检查什么？

查看 finish_reason。如果值为 length，表示达到了上限，请增加 max_tokens 或缩短提示词。参考 列出了所有可能的值。

余额与计费

如何充值？

从账户为预付余额充值。无需订阅，且未使用的余额始终有效，因为额度永不过期。

试用额度用完后会发生什么？

试用额度有效期为 7 天。额度耗尽或过期后，请求将返回 402 状态码，并附带错误代码 no_credit，直到你为余额充值。

我可以查看请求的成本吗？

每个响应都包含一个 usage 块，其中列出了提示词、补全和总 token 数。将其乘以每百万 token 的费率即可得出费用。如果需要账本，请自行记录。

失败的请求可以免费重试吗？

允许重试，但需保持限制。对 429 和 503 使用短延迟，不要对 400、401、402 或 403 循环重试，因为它们不会自行修复。错误处理手册 提供了现成的策略。

内容与行为

模型不会做什么？

合法的成人内容、小说或争议性话题均不会被拒绝。唯一的例外是涉及未成年人的性内容，这类内容每次都会被拦截并返回 403 状态码，即使在故事和角色扮演中也是如此。服务面向 18 岁及以上成年人。

我的提示词会被用于训练模型吗？

不会。提示词不用于训练。

这与通过聚合器路由有何不同？

聚合服务会将你转发至众多模型，每个模型都有各自的规则。该服务仅对应一个模型和一项策略。Uncensored OpenRouter 指南详细演示了该对比。

它支持图像或生成嵌入向量吗？

不支持。它仅处理文本，不支持嵌入向量、图像、音频、视频或微调。

故障排除

我收到了 402 和 no_credit 错误。现在该怎么办？

你的余额已用完或试用已过期。请为预付余额充值，然后重新发送请求。

请求返回 503 upstream_busy。

这是暂时性的。等待几秒后重试。如果你运行多个工作进程，请使用递增的延迟并加入一些随机性。

流式输出结束，但我找不到 token 计数。

开启流式输出后，会自动添加一个包含 usage 的最终块，位于 data: [DONE] 之前。其 choices 列表为空，因此在索引前请检查该情况。

工具调用和函数调用支持吗？

支持，采用标准格式：传递 tools 数组，并在回复中查找 tool_calls。