更新于

Grok API 国内调用指南与场景实测


Grok 4 是 xAI 2025 末发布的旗舰,主打”实时搜索 + 数学/物理推理”。在国内用 Grok 通过中转最简单:xAI 官方提供 OpenAI 兼容 API,国内中转只要做正确转发就能用。

一、最小调用

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_YOTRADE_KEY",
    base_url="https://yotradeapi.com/v1",
)

resp = client.chat.completions.create(
    model="grok-4",
    messages=[
        {"role": "system", "content": "你回答简洁、不啰嗦。"},
        {"role": "user", "content": "证明素数无穷多。"},
    ],
)
print(resp.choices[0].message.content)

二、Grok 4 实测场景

数学与物理

题型Grok 4Claude Opus 4.7GPT-5
大学高等数学9.0/108.78.5
数学奥赛8.58.28.0
物理推导9.28.88.5

数学/物理是 Grok 的强项。把它当”作业辅导”或”研究助手”非常合适。

编程

题型Grok 4Claude Opus 4.7
写函数8.59.0
调 bug8.09.0
跨文件重构7.59.0

编程能力不如 Claude Opus,但对于”一次性脚本”够用。

中文表达

维度Grok 4Claude Opus 4.7
中文流畅度7.59.0
中文事实准确7.08.5

Grok 的中文能力比一年前有大幅进步,但仍不及 Claude/GPT。写对外中文文档不是它的强项。

Grok 最大的卖点是接 Twitter/X 的实时数据。OpenAI 兼容下的开启方式:

resp = client.chat.completions.create(
    model="grok-4",
    messages=[{"role": "user", "content": "今天 AI 圈有什么新闻?"}],
    extra_body={
        "search_parameters": {
            "mode": "on",
            "sources": [{"type": "x"}, {"type": "web"}],
            "max_search_results": 10,
        }
    },
)

注意点

  • 中转必须透传 search_parameters,多数中转默认不透传
  • 实时搜索是额外计费的,单价显著高于纯推理
  • 国内场景下”X 实时数据”价值有限,更多用 {"type": "web"} 单源
  • 返回里 usage 会多一个 num_sources_used 字段

四、长上下文表现

Grok 4 标称 256k tokens 上下文,比 Claude/GPT 大,但比 Gemini 2.5 Pro 小。实测:

输入大小召回质量
< 32k
32–100k
> 100k一般,偶有遗漏

128k+ 的「大海捞针」选 Gemini 比 Grok 稳。

五、Tool Use

完全兼容 OpenAI 协议:

tools = [{
    "type": "function",
    "function": {
        "name": "calculate",
        "description": "计算数学表达式",
        "parameters": {
            "type": "object",
            "properties": {"expr": {"type": "string"}},
            "required": ["expr"],
        },
    },
}]

实测 tool 选用准确率高(94%+),与 GPT-5、Claude Opus 持平。

六、Cursor / Cline 中怎么配

跟其它 OpenAI 兼容模型一样:

  • Endpoint: https://yotradeapi.com/v1
  • Model: grok-4grok-4-fastgrok-code-fast
  • API Key: 中转 key

Cursor 用户特别建议添加 grok-code-fast 当快查模型,响应速度比 Sonnet 略快。

七、成本对比

Grok 4 价格大致在 Claude Sonnet 与 Opus 之间。具体到任务:

  • 数学 / 物理推理:Grok 性价比最高
  • 通用编程:Claude Sonnet 性价比最高
  • 长上下文:Gemini Flash 性价比最高
  • 高频对话:Claude Haiku 或 Gemini Flash-Lite

八、什么时候选 Grok

  • ✓ 数学、物理、工程推导任务
  • ✓ 需要实时信息(X / web 搜索)
  • ✓ 想要一个”不那么 PC”的对话风格
  • ✗ 写中文营销文案(Claude 更好)
  • ✗ 长任务编程代理(Claude Opus 更好)
  • ✗ 超长上下文召回(Gemini 更好)

九、与本地搜索(Brave/Tavily)的组合

如果你不想付 Grok 的实时搜索费,可以自己组合:

# 用 Tavily 或 Brave 搜,再把结果交给 Grok 推理
search_results = tavily_search("AI 行业新闻")
context = "\n".join(r["content"] for r in search_results[:5])

resp = client.chat.completions.create(
    model="grok-4",
    messages=[
        {"role": "system", "content": f"参考资料:\n{context}"},
        {"role": "user", "content": "今天 AI 圈有什么新闻?"},
    ],
)

这样既用上了 Grok 的推理,又避开了 xAI 实时搜索的额外费用。

十、相关阅读

需要一把 Key 同时调 Grok、Claude、GPT、Gemini?在 YoTradeApi 注册 创建 API Key 即可。