Unhinged Grok 用户快速入门

认证和基础 URL

我们的 API 兼容 OpenAI，意味着你无需使用新库。只需更新现有配置中的两个值：base_url 和 api_key。API 密钥在通过 Google 或电子邮件注册后立即生成。请妥善保管该密钥，它是认证所需的唯一凭证。

将标准 OpenAI base URL 替换为我们的接口。此更改将后续所有请求指向我们的无审查模型服务器。基本文本生成无需其他代码更改。

配置示例

• Base URL： https://api.unhingedgrok.com/v1
• API 密钥： 来自仪表板的唯一密钥

通过列出可用模型来验证连接。这在发送生成请求前确认认证是否正常工作。

首次请求

首先发送一个简单的文本补全请求。此示例使用 curl 演示原始 HTTP 结构。请求针对 /v1/chat/completions 接口，模型 ID 为 uncensored。响应在 choices 数组中返回生成的文本。

这种直接方法适用于任何支持标准 OpenAI HTTP 格式的语言或工具。生成密钥后即可立即测试。

直接 HTTP 请求

复制curl https://api.unhingedgrok.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."}]
  }'

Python SDK 集成

使用官方 OpenAI Python 库集成我们的 API。通过 pip 安装软件包。使用你的密钥和自定义 base URL 初始化客户端。其余 SDK 方法（如 chat.completions.create）与 OpenAI 文档中描述的一样工作。

此方法非常适合后端服务、数据处理脚本或自动化工作流。SDK 自动处理 JSON 序列化和响应解析。

Python 代码示例

复制from openai import OpenAI

client = OpenAI(base_url="https://api.unhingedgrok.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 npm 包。使用相同的 base URL 和密钥配置客户端。Node SDK 支持回调和基于 promise 的模式。

此设置允许你将无审查文本生成直接嵌入到 Web 应用、无服务器函数或基于 Node 的自动化工具中。错误处理与标准 OpenAI SDK 行为保持一致。

Node.js 代码示例

复制import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.unhingedgrok.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 启用实时 token 生成。API 返回服务器发送事件 (SSE) 流。每个块包含部分响应。最后一个块包含 token 使用统计信息。

流式输出降低最终用户的感知延迟。对于聊天界面和交互式应用至关重要。增量处理每个块以立即更新 UI。

流式输出代码示例

复制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)

限制、错误和上下文

了解运行限制以避免服务中断。上下文窗口总计支持 100,000 token，如果未设置 max_tokens，响应将一直持续到窗口末尾。

速率限制允许每个密钥每分钟 300 个请求。并发请求上限为 8 个。请求体不得超过 8 MB。处理标准 HTTP 错误代码：401 表示密钥无效，402 表示额度不足，429 表示速率限制。错误不消耗额度。