Grok 网页版免费额度领取与使用说明

接口地址与鉴权

xAI 的 API 与 OpenAI 接口风格高度兼容，base_url 形态为 https://api.x.ai/v1，聊天补全路径为 /chat/completions。鉴权使用在 xAI 开发者平台控制台创建的 API Key，通过请求头 Authorization: Bearer 你的密钥 传递。密钥只在创建时完整显示一次，请立即保存到环境变量中。

先把密钥写入环境变量，避免硬编码进代码：

export XAI_API_KEY="你的_API_密钥"

模型名与获取途径

常用模型名形如 grok-4、grok-4-fast 这类标识，具体可用列表请以控制台或模型列表接口的实际返回为准，不要凭记忆硬写。可通过下面的请求拉取当前账号可用的模型：

curl https://api.x.ai/v1/models \
  -H "Authorization: Bearer $XAI_API_KEY"

一次对话补全调用

最小可用请求如下，关键参数为 model（模型名）、messages（消息数组，role 取 system、user、assistant）、temperature（随机性，0 到 2 之间）与 max_tokens（回复长度上限）。长对话可加 stream 开启流式输出。

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4",
    "messages": [
      {"role": "system", "content": "你是一名简洁的技术助手"},
      {"role": "user", "content": "用三句话说明什么是向量数据库"}
    ],
    "temperature": 0.7,
    "max_tokens": 512
  }'

同样的请求用 Python 发起，便于集成到后端服务：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

resp = client.chat.completions.create(
    model="grok-4",
    messages=[{"role": "user", "content": "写一段 50 字的产品简介"}],
    temperature=0.7,
    max_tokens=512,
)
print(resp.choices[0].message.content)

额度耗尽与限流的排查顺序

• 典型表现：返回 401 多为密钥错误或未带上 Bearer 前缀；返回 403 常见于账号未开通或权限不足；返回 429 表示触发速率限制或余额不足；返回 400 多为模型名拼写错误或参数越界。
• 第一步查余额：登录 xAI 开发者平台控制台查看剩余额度与账单状态，API 为预付制，余额为 0 时请求会直接失败。注意网页版免费额度与 API 额度是两套体系，互相不通。
• 第二步查密钥：确认环境变量是否在当前终端生效，可执行 echo $XAI_API_KEY 验证；在服务器部署时注意区分 shell 与进程的环境变量。
• 第三步查模型名：重新调用模型列表接口核对，避免使用控制台未开放的标识。
• 第四步查限流：遇到 429 先降低并发并加入指数退避重试，单次等待从 1 秒起逐步翻倍；流式请求失败时要读取完整响应体，不要只看 HTTP 状态码。
• 第五步查网络：确认请求域名是 api.x.ai，不要误写成网页版域名 grok.com，后者不提供 API 服务。