基础 URL 与身份验证
我们的 API 遵循 OpenAI Chat Completions 标准。要与服务交互,您必须将客户端指向 https://api.grokapikey.com/v1 并在 Authorization 标头中包含唯一的 API 密钥。注册时只需电子邮件和密码即可立即生成此密钥。密钥在创建时显示一次,请妥善保存。如果丢失,您可以从仪表板重新生成新密钥,这将立即撤销旧密钥。试用账户无需绑定信用卡。
您的首个请求
首先发送一个简单的文本提示词以验证连接。使用标准 chat/completions 接口,模型标识符为 uncensored。以下示例演示了用于测试连接的基本 curl 命令。这确认了您的身份验证正确且服务正在响应。然后,您可以将此结构适配到您的特定应用程序逻辑中。
运行此命令前,请将 YOUR_API_KEY 替换为您的实际密钥。
curl https://api.grokapikey.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 集成
如果您正在构建 Python 应用程序,请使用官方 openai 库。配置客户端以使用我们的基础 URL 和 API 密钥。这使您能够利用熟悉的 Python 惯用法访问无审查模型。客户端自动处理序列化和流式输出。确保您的环境安装了最新版本的库,以便与我们的接口获得最佳兼容性。
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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 项目,Node.js OpenAI SDK 开箱即用。在配置对象中设置 apiKey 和 baseURL 属性。这确保所有后续请求都通过我们的基础设施路由。您可以使用标准的 async/await 模式处理响应。这种方法非常适合需要直接 API 访问且无需通过 OpenAI 代理的服务器端应用程序或边缘函数。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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);
流式响应
对于受益于实时 token 生成的应用程序,请在请求正文中设置 stream: true 以启用流式输出。API 返回服务器发送事件 (SSE) 的部分响应流。这降低了用户的感知延迟,并允许立即显示生成的文本。每个块包含响应的增量。在客户端代码中处理这些事件以逐步更新 UI。流式输出正常消耗 token,不影响定价。
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)
限制、错误与上下文
每个 API 密钥限制为每分钟 300 次请求,最大请求正文大小为 8 MB。如果超出速率限制,API 将返回 429 状态码;等待几秒后重试。401 错误表示密钥无效或已被撤销,而 402 错误表示您的预付额度已耗尽。该模型支持 100,000 个 token 的上下文窗口,适用于输入和输出总和。确保您的提示词在此限制内,以避免截断。内容过滤保持最少,仅对涉及未成年人的色情内容有硬性屏蔽。