Grok API
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/v1
3

使用 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 openai
Python
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 openai
TypeScript
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.5
7

配置 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:等待后重试,或申请更高限额。
余额不足:充值或使用测试额度。

下一步