API 文档

认证和基础 URL

使用您的 API 密钥对每个请求进行身份验证。基础 URL 为 https://api.nsfwroleplayapi.com/v1. 设置 Authorization 请求头以 Bearer YOUR_API_KEY. 您的密钥授予对 chat-completions 端点的访问权限。

聊天完成端点

将提示发送到 POST /v1/chat/completions. 指定模型 "uncensored" 在请求体中。API 根据输入返回生成的文本。

context_window 总共允许 100,000 个 token。这包括提示和补全。您可以设置 max_tokens 限制输出。

Copycurl https://api.nsfwroleplayapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Confirm monthly credit balance is active"}]
  }'

流式传输与 token 使用情况

通过将 stream: trueAPI 随令牌生成发送服务器发送事件（SSE）。在你的应用中接收实时文本更新。这改善了长响应的用户体验。

最后一个数据块包含总令牌使用量。请准确跟踪预付费信用的消耗情况。错误不会消耗信用额度。

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)

参数：温度、Top P 和 JSON 模式

使用 temperature 和 top_p. 调整这些参数以改变创造性或确定性。使用 response_format 与 {"type": "json_object"} 用于结构化数据。这确保输出格式一致。

您还可以设置 seed 用于获得可复现的结果。设置 stop 序列以提前终止生成。这些参数让您获得精确控制。

Copyfrom openai import OpenAI

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

速率限制与并发

每个 API 密钥支持每分钟 300 次请求。您可以同时运行 8 个并发请求。请求体大小限制为 8 MB。超出这些限制将返回 429 错误。

您可以创建新密钥以替换旧密钥。每个账户只允许一个活跃密钥。管理您的密钥以维持访问权限。这确保了稳定的性能。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.nsfwroleplayapi.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);

错误处理和拒绝

通过检查 HTTP 状态码来处理错误。401 错误表示您的 API 密钥无效。402 错误表示预付费余额不足。通过仪表板刷新余额。

429 错误表示速率限制已耗尽。等待后再重试。模型会拒绝涉及未成年人的请求。允许所有其他合法的成人内容。请查看响应体以获取详细信息。