Quick start
Grok API 快速开始
几分钟内将 Grok 连接到应用程序或编程工具并获得第一个响应。
GrokAPI 使用 OpenAI 兼容协议。大多数集成只需替换 API 密钥、base URL 和模型名称。
1
创建账号和 API 密钥
注册并验证邮箱,然后在个人中心创建项目密钥。请立即复制,之后不会再次完整显示。
创建账号2
保存连接设置
将凭据存储在环境变量中。不要将真实密钥提交到 git,也不要暴露在浏览器代码中。
.env
GROK_API_KEY=sk-grok-YOUR_API_KEY
GROK_BASE_URL=https://api.llm-gate.tech/v13
使用 cURL 检查 API
发送最小的 Chat Completions 请求。成功响应会在 choices[0].message.content 中包含文本。
终端
curl https://api.llm-gate.tech/v1/chat/completions \
-H "Authorization: Bearer sk-grok-YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"messages": [{"role": "user", "content": "Reply with: connection works"}],
"stream": false
}'4
连接 Python SDK
安装官方 OpenAI SDK,并向客户端传入 GrokAPI base URL。
终端
pip install openaiPython
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["GROK_API_KEY"],
base_url="https://api.llm-gate.tech/v1",
)
response = client.chat.completions.create(
model="grok-4.5",
messages=[{"role": "user", "content": "Hello, Grok"}],
)
print(response.choices[0].message.content)5
连接 TypeScript SDK
同样的 OpenAI 兼容设置适用于 Node.js 和服务端 TypeScript 应用。
终端
npm install openaiTypeScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.GROK_API_KEY,
baseURL: "https://api.llm-gate.tech/v1",
});
const response = await client.chat.completions.create({
model: "grok-4.5",
messages: [{ role: "user", content: "Hello, Grok" }],
});
console.log(response.choices[0].message.content);6
配置 Cursor
打开 Cursor Settings → Models,选择 OpenAI-compatible provider,然后填写以下值。
配置
Provider: OpenAI Compatible
Base URL: https://api.llm-gate.tech/v1
API Key: sk-grok-YOUR_API_KEY
Model: grok-4.57
配置 Cline
打开 Cline 设置,选择 OpenAI Compatible,并填写 base URL、API 密钥和 Model ID。
配置
API Provider: OpenAI Compatible
Base URL: https://api.llm-gate.tech/v1
API Key: sk-grok-YOUR_API_KEY
Model ID: grok-4.5如何验证连接
让模型返回简短回答。如果出现流式文本并且控制台余额发生变化,则连接成功。
常见错误
401 Unauthorized:检查密钥并确保它以 sk-grok- 开头。
404 Not Found:base URL 必须包含 /v1。
429 Too Many Requests:等待后重试,或申请更高限额。
余额不足:充值或使用测试额度。