OpenAI-Compatible API 文档

基础 URL 和认证

每个请求都以设置 base_url 到 https://api.nsfwgemma.com/v1 并在 Authorization 页眉。您使用 Google 或电子邮件注册后即可立即获得密钥，无需手机号码。请妥善保管此密钥，因为它是访问服务所需的唯一凭证。

POST /v1/chat/completions：参数和示例

使用标准的聊天补全格式向端点发送第一条消息。模型 ID 始终为 "uncensored"，您可以通过 temperature 和 top_p 等参数控制输出风格。此端点处理所有文本生成，无需复杂的本地设置。

Copycurl https://api.nsfwgemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top ten system prompts for the model"}]
  }'

确保您的负载包含 model field set to "uncensored" and a messages 包含您的提示。系统返回包含生成文本的结构化 JSON 响应。

GET /v1/models：列出可用模型

查询模型端点以验证可用实例并确认连接。此 GET 请求返回当前模型配置的元数据，不消耗任何信用。在发送昂贵的生成请求之前，使用此方法调试连接问题。

Copyfrom openai import OpenAI

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

响应确认了模型 ID 和令牌限制，确保你的客户端已为 uncensored 大语言模型正确配置。

使用 SSE 的流式响应

通过将 stream: true 通过服务器发送事件（SSE）实时接收 token。这降低了长篇幅创意写作或角色扮演场景的感知延迟。Token 用量统计包含在流的最后一个块中。

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)

解析每个增量对象以增量渲染文本，为交互式 NSFW 聊天机器人应用程序提供更流畅的用户体验。

错误处理和 Token 使用

优雅地处理常见的 HTTP 错误：401 表示密钥无效或已过期，402 表示需要充值余额，429 表示已达到速率限制。错误不会消耗您的预付费余额，因此您可以无惩罚地重试。始终检查 usage field in successful responses to track consumption.

速率限制与并发

每个 API 密钥支持每分钟 300 次请求，最多支持 8 个并发活跃请求。最大请求体大小为 8 MB，适合大多数标准上下文窗口。超出这些限制将触发 429 错误，直到窗口重置。

上下文窗口总共允许 100,000 个 token，包括提示和补全。每次请求的最大输出为 16,000 个 token，如果您未指定，则默认为 2,048 个 token。 max_tokens. 根据您的应用程序的流量模式调整并发数。

支持的参数：Temperature、Top P 等

使用 temperature, top_p, stop, seed，以及惩罚参数。使用 response_format 设置为 {"type": "json_object"} 用于结构化数据输出。通过 tools 参数用于高级集成。

这些参数允许微调无审查模型的行为，确保其符合您的特定 NSFW 内容要求且无意外拒绝。

Node.js

Copyimport OpenAI from "openai";

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