Grok 用户快速入门
在几分钟内将现有的 Grok API 集成迁移至我们的无审查 OpenAI 兼容接口。本指南涵盖 SDK 配置、流式输出、函数调用以及寻求即插即用替代方案的开发者的关键限制。
安装 OpenAI SDK
我们的 API 遵循标准的 chat-completions 架构,因此你可以复用官方的 OpenAI Python、Node.js 及其他语言的 SDK。请确保已安装首选客户端库的最新版本。这种方法允许你在替换 Base URL 和认证密钥的同时保持现有应用逻辑不变。你不需要自定义客户端或复杂的路由层。唯一的要求是你的代码支持标准的 OpenAI 兼容参数,如 model、messages 和 stream。
配置 Base URL 和密钥
将 SDK 客户端指向我们的 Base URL:https://api.uncensoredgrok.com/v1。将 model 参数设置为 uncensored 以访问我们的开放权重模型。在仅使用电子邮件和密码注册后,从“获取 API 密钥”页面获取你的 API 密钥。开始使用无需信用卡。密钥在注册后立即显示,且可随时重新生成,这将使旧密钥失效。此简单配置可确保请求正确路由至我们的 GPU 服务器,无需任何隐藏的模型路由或聚合层。
发送第一个补全请求
向 /v1/chat/completions 发送标准 POST 请求。该模型接受文本输入并返回文本输出。需要注意的是,我们不提供嵌入、图像生成、音频处理或微调接口。仅提供 chat-completions 接口。我们的模型针对无需内容拒绝的回答进行了调整,适用于合法的成人、虚构或争议性话题。但是,始终存在硬性限制:包含未成年人色情内容的请求将被屏蔽。对于所有其他合法内容,模型将直接处理请求,无需中间过滤器。
启用流式响应
通过在请求中将 stream 参数设置为 true 来启用流式输出。API 返回服务器发送事件 (SSE),你可以逐 token 解析。这非常适合实时用户体验。响应格式符合标准的 OpenAI 流式协议,因此你现有的流解析器无需修改即可工作。你可以处理到达的部分 token,从而降低用户的感知延迟。此功能在 chat-completions 接口上受支持,并与 Python 和 Node.js SDK 无缝协作。
使用函数调用
完全支持函数和工具调用。你可以在 tools 参数中定义工具,让模型决定何时调用。响应包含工具调用,你可以在应用逻辑中执行,然后将结果反馈到对话中。这无需外部编排即可实现复杂工作流。模型透明地处理工具定义和调用。注意,我们不提供模型路由或多模型选择;这个无审查模型原生处理所有工具交互。
限制、错误和上下文窗口
我们的模型支持 100,000 token 的上下文窗口,结合提示词和补全 token。请求体大小限制为 8 MB。每个 API 密钥每分钟允许 300 个请求。如果收到 401 错误,表示密钥无效或已过期。402 错误表示预付额度不足。429 错误表示你已超出速率限制。定价透明:输入 token 每 1M 为 $0.15,输出 token 每 1M 为 $0.50。额度永不失效。检查可用模型接口以确认模型 ID 为 uncensored。
cURL
curl https://api.uncensoredgrok.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.uncensoredgrok.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.uncensoredgrok.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 和密钥 |
| Base URL | https://api.uncensoredgrok.com/v1 |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 模型 ID | uncensored |
| 认证 | Authorization: Bearer YOUR_KEY |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| JSON 模式 | response_format: {"type": "json_object"} |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 请求大小 | 每次请求不超过 8 MB |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 并发 | 每个密钥同时最多 8 个请求 |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10%,满 $200 送 15% |
| 价格 | 输入 $0.15 / 百万 tokens · 输出 $0.50 / 百万 tokens |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 充值 | USDT(TRC20)或 USDC(Base),$20–$500 任意整数金额 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 登录 | 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 | 模型繁忙——几秒后重试 |
问答
这是官方的 Grok API 吗?
不是。我们是独立服务。我们不是 OpenAI、xAI 或任何其他供应商。我们的模型是一个开放权重模型,在我们的服务器上运行,针对无审查响应进行了调整。它与 Grok API 格式兼容,但是一款独立的产品。
你们会使用我的提示词进行训练吗?
不会。发送到我们 API 的提示词不用于训练。我们专注于提供纯粹的 API 功能。无需复杂的企业协议即可保障你的数据隐私。
如果额度用完会怎样?
在你充值预付额度之前,请求将返回 402 错误。你可以使用加密货币(USDT 或 USDC)支付,最低 $20。额度永不失效,因此你可以按自己的节奏暂停和恢复使用。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改 Base URL。这就是全部设置。