快速入门 for Grok Unrestricted users
在几分钟内将现有的 OpenAI 兼容客户端连接到我们的无审查模型。替换 Base URL 和 API 密钥,然后向你已知的相同接口发送请求。
前提条件
发送请求前,请确保已拥有 API 密钥,并配置好适用于 OpenAI 兼容接口的客户端。使用 Continue with Google或电子邮件和密码在我们的网站上创建账户。你的 API 密钥会立即显示,也是你唯一的凭证。初始设置无需手机号或信用卡。你将获得 7 天内有效的 $0.50 免费试用额度,用于测试接口。在 API 密钥页面一键领取此额度。生产环境使用可通过 USDT (TRC20) 或 USDC (Base) 充值。该服务支持标准文本输入、文本输出的工作流,上下文窗口为 100,000 token。
认证
在每次请求的 Authorization 请求头中包含你的 API 密钥。使用 Bearer 方案,后跟你的密钥字符串。这将向 api.grokunrestricted.com 基础 URL 验证你的账户。如果密钥无效或缺失,API 将返回指示身份验证失败的错误。确保你的密钥是最新的;生成新密钥将替换旧密钥。标准聊天补全无需其他作用域或权限。
聊天 补全 接口
向 POST /v1/chat/completions 接口发送消息。将模型 ID 指定为 uncensored。请求正文应包含带有你的对话历史的 messages 数组。API 在 choices 数组中返回文本响应。此接口支持 temperature、top_p 和 stop 等标准参数。请求按实际 token 使用量计费。错误和拒绝不产生费用。
流式输出 响应
使用服务器发送事件(SSE)进行流式输出。在请求中将stream 设置为 true。API 会返回一个数据块流,每个数据块包含部分文本。最后一个数据块包含该请求的总 token 用量。此方法可降低大型响应时的感知延迟。使用官方 SDK 可自动处理流解析。流式输出支持所有标准参数。
函数 调用
通过在请求中提供 tools 数组来启用工具使用。使用名称、描述和参数模式定义函数签名。在适当时,模型会在响应中返回工具调用。你必须在本地执行工具,并在后续消息中将结果传回。API 不验证工具输出的准确性;你负责处理结果。使用 tool_choice 控制模型如何选择函数。
JSON 模式
通过将 response_format 设置为 {"type": "json_object"} 强制模型输出有效的 JSON。这对于结构化数据提取或配置生成很有用。模型将尝试符合 JSON 语法规则。确保你的提示词清楚地描述了预期的结构。如果模型难以处理复杂的模式,仍可能出现无效的 JSON 响应。在客户端解析之前验证输出。
cURL
curl https://api.grokunrestricted.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
from openai import OpenAI
client = OpenAI(base_url="https://api.grokunrestricted.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokunrestricted.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 = 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:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| 模型 ID | uncensored |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.grokunrestricted.com/v1 |
| 认证 | Authorization: Bearer YOUR_KEY |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| JSON 模式 | response_format: {"type": "json_object"} |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 并发 | 每个密钥同时最多 8 个请求 |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 请求大小 | 每次请求不超过 8 MB |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10%,满 $200 送 15% |
| 充值 | USDT(TRC20)或 USDC(Base),$20–$500 任意整数金额 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 价格 | 输入 $0.15 / 百万 tokens · 输出 $0.50 / 百万 tokens |
| 登录 | 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 | 模型繁忙——几秒后重试 |
问题 and answers
如何处理速率限制?
每个 API 密钥每分钟允许 300 次请求,并发请求数为 8。如果超出这些限制,API 将返回错误。你应在客户端实现带有指数退避的重试逻辑,以高效处理临时过载。
如果额度用完会发生什么?
如果账户余额不足,请求将失败。错误是免费的,因此因资金不足导致的失败请求不会收费。使用加密货币充值以恢复服务。预付额度永不过期。
上下文窗口总共是 100k token 吗?
是的,提示词和补全的上下文窗口总共为 100,000 个 token。没有单独的输出上限。如果你未指定 max_tokens,响应可以一直运行到窗口结束。
你的 key is one form away
创建账户,复制密钥,更改基础 URL。这就是全部设置。
获取 API 密钥