xAI Grok API Quickstart — OpenAI-Compatible Frontier Model

简介

xAI 的 Grok API 跟 OpenAI 兼容 —— OpenAI SDK 指向 api.x.ai/v1，带 XAI_API_KEY，改 model='grok-3' 就跑 Grok。Grok-3 是旗舰推理模型，1M token 上下文；Grok-2 Vision 处理图片；Live Search 让调用内拿到实时网页结果。适合需要新鲜实时知识（新闻 / 价格 / 体育）的应用、不想单独搭 retrieval 层、超长上下文（>20 万 token）任务。兼容 openai-python、openai-node、LangChain、LlamaIndex（走 OpenAI-compatible 适配器）。装机时间 2 分钟。

Python（openai SDK）

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="grok-3",
    messages=[{"role": "user", "content": "本周 SpaceX 发射最新进展是什么？"}],
)
print(resp.choices[0].message.content)

Grok-2 视觉

resp = client.chat.completions.create(
    model="grok-2-vision-latest",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "这个 UI 截图哪里不对？"},
            {"type": "image_url", "image_url": {"url": "https://example.com/screenshot.png"}},
        ],
    }],
)

Live Search（实时网页 grounding）

resp = client.chat.completions.create(
    model="grok-3",
    messages=[{"role": "user", "content": "BTC 现在多少钱？今天上涨/下跌的前 3 大原因？"}],
    extra_body={
        "search_parameters": {
            "mode": "on",          # off | auto | on
            "sources": [{"type": "web"}, {"type": "x"}, {"type": "news"}],
            "max_search_results": 8,
        }
    },
)
print(resp.choices[0].message.content)
print(resp.usage.num_sources_used)  # Grok grounding 用了几个源

模型阵容

价格（每百万 token，2026 年 5 月）

• Grok-3：输入 $5 / 输出 $15
• Grok-3-mini：输入 $0.30 / 输出 $0.50

从 OpenAI 迁移

只改 base_url 和 model 字符串。Tools、视觉、JSON 模式、流式 —— 全一致。

FAQ

Q: Grok 1M 上下文跟 Gemini 2M 比？ A: 全语料任务两个都行。Grok-3 的 1M 单位美元更稠 $5/M 输入。Gemini 2.5 Pro ~$1.25/M 但限流更严。10–50 万 token 典型任务 Grok 端到端更快；>80 万都行。

Q: Live Search 索引哪些源？ A: Web（搜索引擎）、X（Twitter post）、News（媒体文章）、RSS。在 sources 数组里白名单。Grok 返回内联引用和 num_sources_used 计数供核对。

Q: OpenAI 兼容层功能齐全吗？ A: 基本齐 —— chat.completions、流式、tools、视觉、JSON 模式都能用。音频（TTS / Whisper）xAI API 没有，那个得用 OpenAI。Embeddings：截至 2026 年 5 月 xAI 还没上。