NsfwAiApi/文档
NSFW AI API 文档
使用标准的 OpenAI 兼容库,几分钟即可开始使用无审查 LLM API。本指南涵盖身份验证、基本请求、流式输出以及关键限制,以实现快速集成。
- Base URL
- https://api.nsfwaiapi.com/v1
- 模型
- 无审查
基础 URL 和身份验证
使用标准 OpenAI SDK 格式调用 nsfw ai api。你的基础 URL 为 https://api.nsfwaiapi.com/v1。通过 Authorization 标头中的 Bearer token 进行身份验证。在仪表板生成密钥;注册后立即显示。初始试用无需信用卡或电话号码。
确保你的客户端库指向我们的基础 URL。API 提供单一的无审查模型,因此大多数请求无需选择模型版本。如果更换密钥,旧密钥将立即失效。
首次请求
发送一个简单的文本补全以验证连接。接口 POST /v1/chat/completions 接受标准的聊天消息。使用模型 ID uncensored 确保你被路由到专为成人内容优化的开放权重模型。
此请求演示了核心功能:文本输入,文本输出。模型将针对合法的成人主题做出响应,且没有标准的内容过滤器。
- 接口:
POST /v1/chat/completions - 模型:
uncensored - 格式:JSON
curl https://api.nsfwaiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'如果收到 401,请检查你的 API 密钥。402 表示你的预付额度已耗尽。
Python SDK 集成
使用官方 OpenAI Python 库快速集成。设置 base_url 和 api_key 以匹配我们的服务。此方法适用于同步和异步工作流。
模型 ID 仍为 uncensored。上下文窗口支持最多 100,000 个 token,提示词和补全内容合计。这允许进行长篇幅的角色扮演或详细分析,而不会过早截断。
from openai import OpenAI
client = OpenAI(base_url="https://api.nsfwaiapi.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)此方法非常适合顺序处理文本的后端服务。请记住,提示词不用于训练,从而保护你的数据隐私。
Node.js SDK 集成
对于 JavaScript 或 TypeScript 项目,请使用 OpenAI Node.js SDK。使用我们的基础 URL 和 API 密钥配置客户端。这使 Web 服务器或 Node.js 脚本能够无缝集成。
确保适当处理错误,例如速率限制或余额不足。API 支持函数调用,允许你定义模型可以调用的函数。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nsfwaiapi.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);此设置非常适合实时聊天机器人或内容生成管道。按量付费模式意味着你只需为使用的内容付费,没有月费。
流式响应
对于聊天机器人,流式输出可降低感知延迟。通过在请求中设置 stream: true 启用流式输出。API 返回带有增量数据块的服务器发送事件 (SSE)。
这对于角色扮演场景中的用户体验至关重要。模型按顺序生成 token,并在准备就绪时发送它们。
stream = 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)在客户端处理流以实时显示文本。这适用于任何 OpenAI 兼容的流式解析器。
限制、错误和配额
监控你的使用情况以避免服务中断。API 对每个密钥实施每分钟 300 次请求的限制。最大请求体大小为 8 MB。
常见错误包括 401(密钥无效)、402(无余额)和 429(速率限制)。额度永不过期,方便时充值即可。预付额度从 $10 起,金额越大奖励越多。
上下文窗口为 100,000 个 token。确保你的提示词在此限制内。无审查模型会屏蔽涉及未成年人的性内容,这是硬性限制。
API 技术参数
所有限制、功能与价格一览。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| 认证 | Authorization: Bearer YOUR_KEY |
| 模型 ID | uncensored |
| Base URL | https://api.nsfwaiapi.com/v1 |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| JSON 模式 | response_format: {"type": "json_object"} |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 并发 | 每个密钥同时最多 8 个请求 |
| 请求大小 | 每次请求不超过 8 MB |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10% |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 价格 | 输入 $0.25 / 百万 tokens · 输出 $1.00 / 百万 tokens |
| 充值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整数金额 |
| 内容政策 | 允许成人内容;涉及未成年人的性内容一律拒绝 |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
| 登录 | Google 或邮箱 + 密码 |
错误说明
错误以 JSON 返回,type 字段固定;失败或被拒绝的请求不计费。
| 状态码 | 类型 | 含义 |
|---|---|---|
400 | bad_request | JSON 无效、消息为空、参数错误或超出上下文窗口 |
401 | missing_key · invalid_key · key_revoked | 缺少密钥、密钥错误或已被新密钥替换 |
402 | no_credit | 余额不足——充值后立即恢复 |
403 | content_blocked | 涉及未成年人的性内容——拒绝且不计费 |
404 | not_found | 未知接口 |
413 | request_too_large | 请求体超过 8 MB |
429 | rate_limited · concurrency | 超过每分钟 300 次或 8 个并发——稍后重试 |
503 | upstream_busy | 模型繁忙——几秒后重试 |
问答
此 API 适合用于角色 AI 机器人吗?
是的,无审查模型专为角色扮演和角色交互进行了优化。它能针对成人主题做出响应,且没有标准的拒绝机制,非常适合沉浸式聊天机器人。
提示词会被用于训练吗?
不会。你的提示词和补全内容不会用于训练模型。这确保了你的独特内容和角色数据的隐私。
如果触发速率限制会怎样?
你将收到 429 状态码。你必须等待窗口重置或降低请求频率。如果需要,你可以重新生成 API 密钥,但限制是针对每个密钥应用的。