5 分钟发起首个请求

基础 URL 与身份验证

我们的 API 镜像 OpenAI v1 接口，允许你在不更改应用程序逻辑的情况下切换端点。使用 https://api.groknsfw.top/v1 作为你的基础 URL。身份验证需要在 Authorization 头中传递有效的 API 密钥作为 Bearer token。你可以通过仪表板上的 Google 登录或电子邮件即时生成此密钥。每个账户同时只支持一个活动密钥；生成新密钥会立即使旧密钥失效。这种单密钥模型简化了大多数开发和 QA 环境的访问控制。

首个请求

发送标准的聊天补全请求以测试连接性。模型标识符为 uncensored，其处理内容拒绝的方式与标准模型不同。下面是一个使用 curl 命令行工具的基本示例，用于验证你的密钥和基础 URL 是否正确。

Copycurl https://api.groknsfw.top/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."}]
  }'

如果你收到包含 choices 和 usage 的 JSON 响应，说明你的集成已生效。请检查 usage 对象以查看 token 消耗情况，从而实现准确的计费跟踪。

Python SDK 集成

使用官方的 openai Python 包与我们的接口交互。在调用之前设置 base_url 和 api_key 属性。这种方法适用于支持 OpenAI 架构的任何库，使得从其他供应商迁移变得简单直接。

Copyfrom openai import OpenAI

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

此代码片段演示了同步请求。对于高吞吐量的 NSFW 内容生成，建议使用异步客户端，以便在不阻塞主线程的情况下并发处理多个请求。

Node.js SDK 设置

对于 JavaScript 或 TypeScript 应用程序，配置 OpenAI SDK 指向我们的基础 URL。这确保你现有的客户端代码无需修改即可工作。Node.js 生态系统受益于这种兼容性，允许快速原型化 NSFW 聊天应用。

Copyimport OpenAI from "openai";

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

确保你使用的是支持自定义基础 URL 的 SDK 的较新版本。配置对象应严格包含 apiKey 和 baseURL 属性，以避免端点不匹配。

流式响应 (SSE)

通过在请求中设置 stream: true 启用实时 token 生成。API 返回服务器发送事件 (SSE) 流，在生成时交付 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)

解析 SSE 事件以提取 delta 内容。流中的最后一个块包含总 usage 统计信息，你应使用它进行准确的计费对账。流式输出不影响 token 计数或定价。

限制、错误与上下文

你的请求受每分钟 300 次和每个密钥 8 个并发请求的限制。最大请求体大小为 8 MB，上下文窗口总共支持 100,000 个 token。错误以标准 HTTP 格式返回：401 表示密钥无效，402 表示额度不足，429 表示速率限制。额度错误不收费，但速率限制要求你降低请求频率。每次请求的最大输出为 32,000 个 token；省略 max_tokens 时默认值为 2,048 个 token。