Grok API 获取与调用教程：Key、Base URL 与接入（2026）

Grok 是 xAI 的模型系列，API 采用 OpenAI 兼容格式，开发者可以用现有的 OpenAI SDK 调用。国内使用时，常见问题是访问、付款和模型额度管理。

本文讲清楚 Grok API 怎么获取、怎么调用，以及通过网关接入的方式。

说明：Grok、xAI 是其权利人的商标。本文以 2026 年 10 月的常见版本为例，接口和价格以官方/站内为准。

一、Grok API 能做什么

通用问答、写作、总结。
代码生成与解释。
工具调用/Agent。
长上下文文档分析。
多模型对比测试。

具体可用模型名和上下文长度，以模型价格为准。

二、获取 Key 的两条路

官方 xAI

在 xAI 控制台创建 API Key，绑定付款方式。适合能稳定访问、有海外支付方式的团队。

中商起航网关

打开中商起航 AI 网关注册。
创建 API Key，设置额度。
充值。
用 OpenAI SDK 或 curl 调用。

适合国内访问不稳定、需要统一账单和多模型切换的团队。

三、Base URL

官方 xAI 通常是：

https://api.x.ai/v1

中商起航 OpenAI 兼容入口：

https://ai.zhongshangqihang.com/v1

不要把两个地址混用；Key 和 Base URL 要配套。

四、curl 测试

export GROK_API_KEY="sk-你的密钥"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $GROK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4",
    "messages": [{"role": "user", "content": "只回复 OK"}]
  }'

模型名以模型价格为准。

五、Python 调用

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="grok-4",
    messages=[{"role": "user", "content": "用三句话解释 API 网关"}],
)
print(resp.choices[0].message.content)

六、常见报错

报错	原因	处理
401	Key/地址不匹配	检查 Key 和 Base URL
404	路径错	只填到 `/v1`
model not found	模型名不对	从价格页复制
429	限流	降并发、重试
insufficient quota	余额不足	充值

七、成本和选型

Grok 的单价、上下文和工具调用能力会影响成本。估算方法：

统计日均输入/输出 Token。
查当前模型单价。
加上重试和长上下文成本。
对比其他模型，按任务分配。

不要只看单价，长上下文和输出 Token 往往是大头。

常见问题

Grok API 兼容 OpenAI 吗？

通常兼容 Chat Completions 格式，可以用 OpenAI SDK；具体参数支持以官方/网关文档为准。

国内怎么稳定调用？

可以使用官方直连（如果网络允许），或国内可达的网关。

一个 Key 能调多个模型吗？

在网关里可以，模型在请求参数里指定。

下一步

需要国内访问或多模型统一入口，可以先注册中商起航 AI 网关，用小额 Key 测试。模型和价格以模型价格为准。