Grok (xAI) 免费 API 额度怎么领：注册即得赠额与 OpenAI 兼容接入教程

Grok API 的请求格式与 OpenAI 兼容，已有的 OpenAI SDK 或现成代码通常只需替换 base_url 与密钥即可复用。

接口地址与模型名

base_url 形如 https://api.x.ai/v1，对话补全端点为 /chat/completions。可用模型名以控制台模型列表或官方文档显示为准，常见写法形如 grok-2-latest，不要在代码里硬编码自己猜测的模型名。

用 curl 发起一次对话补全

先把密钥放进环境变量，再执行下面的命令，避免密钥被写死在脚本里。

export XAI_API_KEY="你的密钥"
curl https://api.x.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-2-latest",
    "messages": [
      {"role": "user", "content": "用一句话说明什么是向量数据库"}
    ],
    "temperature": 0.7,
    "max_tokens": 256
  }'

返回结果中的 choices[0].message.content 就是模型回答，usage 字段可用来估算本次消耗。

Python 调用示例

from openai import OpenAI

client = OpenAI(
    api_key="你的密钥",
    base_url="https://api.x.ai/v1"
)

resp = client.chat.completions.create(
    model="grok-2-latest",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
    temperature=0.7,
    max_tokens=256
)
print(resp.choices[0].message.content)

关键参数说明如下。

• model：模型标识，必须与控制台列出的名称完全一致。
• messages：消息数组，按 system、user、assistant 角色组织上下文。
• temperature：随机性，取值通常在 0 到 1 之间，写代码类任务可适当调低。
• max_tokens：单次回答的最大长度，设得过小会截断输出。
• stream：设为 true 时以流式返回，适合做打字机效果。

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

1. 返回 401 或 403：先检查密钥是否复制完整、是否已被吊销，以及请求头是否为 Authorization: Bearer 你的密钥。
2. 返回 404 或提示模型不存在：核对 base_url 是否带 /v1，以及模型名是否与控制台一致。
3. 返回 429：多为请求频率超限，降低并发并加上指数退避重试后再试。
4. 提示余额不足或额度耗尽：到控制台的用量与账单页面确认免费赠额是否已用完或已过期，赠额一般不会自动续期，需要重新评估用量或考虑其他方案。