Grok4 API 接入入门 — xAI Console 与 API Key 创建

Grok API 概述

Grok 4 完整开放 REST API，开发者可以在自己的应用中集成 Grok 的对话、推理、工具调用、语音合成等能力。这是 xAI 推动 Grok 生态建设的核心举措——通过 API 让 Grok 成为构建各类 AI 应用的基础模型。

API 能力范围

可用模型列表

通过 API 调用 Grok 时，可以指定的模型 ID（随版本变化）：

以 xAI Console 上的实际可用模型为准。

第一步：创建 xAI Console 账号

1. 访问 console.x.ai
2. 使用 X（Twitter）账号登录，或用邮箱注册
3. 完成注册后进入控制台主页

注意事项

• xAI Console 和 Grok 应用使用同一套账号系统
• API 计费和 SuperGrok 订阅是分开的——即使有 SuperGrok，API 调用仍单独计费
• API 可能需要先添加付款方式才能使用（取决于地区和账户状态）

第二步：创建 API Key

1. 登录 xAI Console
2. 左侧菜单找到 API Keys
3. 点击 Create New Key
4. 给 Key 起个名字（如「my-app-production」）
5. 创建后立即复制保存——API Key 只显示一次！

API Key 安全

• 绝对不要把 API Key 提交到公开的 Git 仓库
• 不要在前端代码（浏览器 JavaScript）中硬编码 API Key
• 必须放在后端服务器的环境变量或密钥管理服务中
• 定期轮换 API Key，旧的可以随时吊销

第三步：调用 API

基础对话调用示例（Python）

import os
from openai import OpenAI

# xAI 兼容 OpenAI SDK
client = OpenAI(
    api_key=os.environ.get("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

# 发送对话
response = client.chat.completions.create(
    model="grok-4.7",
    messages=[
        {"role": "system", "content": "你是一个有用的 AI 助手。"},
        {"role": "user", "content": "Grok 4 和 Grok 4.7 有什么区别？"}
    ],
    max_tokens=1024,
)

print(response.choices[0].message.content)

使用 curl

curl https://api.x.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4.7",
    "messages": [
      {"role": "user", "content": "你好，介绍一下自己"}
    ]
  }'

OpenAI SDK 兼容

xAI 的 API 设计与 OpenAI 的 API 格式高度兼容。如果你已经在使用 OpenAI SDK，只需要把 api_key 和 base_url 换成 xAI 的就可以几乎无缝切换。

API 计费

定价（以 Grok 4.7 为例，可能变化）

计费特点

• 按 token 计费：根据实际使用的 tokens 数量
• 缓存优惠：重复的 prompt 前缀可以缓存，价格更低
• 推理 token 计费：Grok 4 系列的内部思考 token 不计费或低价（取决于具体模型）
• 长上下文加价：超过 20 万 tokens 阈值后价格翻倍

查看用量

在 xAI Console 中可以：

• 查看当前用量
• 设置用量上限（防止超额）
• 查看历史账单
• 导出用量明细

常见请求参数

messages

对话历史数组，支持三种角色：

• system：系统提示词，设定 AI 行为
• user：用户消息
• assistant：AI 之前的回复

model

模型 ID，指定用哪个 Grok 模型。

max_tokens

最大输出 token 数。设得太大浪费钱，太小可能截断回复。

temperature

生成随机性（0-2）。越高越随机，越低越确定。

tools

函数调用定义，详见 函数调用。

response_format

输出格式，支持 json_object（结构化输出，详见 结构化输出）。

常见问题

API 返回 401 Unauthorized

API Key 无效或已吊销。检查 Key 是否正确，注意有没有多余空格。

API 返回 429 Rate Limit

请求太频繁。降低并发或等待配额刷新。可在响应头中查看剩余配额。

API 返回 500/502/503

服务器端问题。等待后重试。可以在 xAI Console 的状态页面查看服务状态。

如何升级/降级订阅

API 计费与 SuperGrok 订阅独立。API 使用按实际调用量计费，不涉及套餐升级。SuperGrok 订阅是应用端的权益，API 是另一条产品线。

API 调用需要 VPN 吗

取决于你的地区和网络环境。xAI API 服务器在海外，国内访问可能需要代理。

继续阅读 函数调用 了解 Grok 原生工具调用能力。