Grok 4.7 是 xAI API 上最新、能力最强的模型,几分钟内就能在终端或一段简短脚本里调用它。本教程会带你创建密钥,用 curl、Python 和 JavaScript 发送第一个请求,然后使用接下来最常用的功能:推理强度、追问、实时联网搜索、费用追踪,以及新推出的内容准则。所有命令均依据 docs.x.ai 上的官方文档,核对时间为 2026 年 11 月 15 日。
要点速览
- Grok 4.7 是 xAI API 上能力最强的模型,上下文窗口为 500,000 个 token。
- 在 console.x.ai 创建密钥,保存为 XAI_API_KEY,再用 curl 或 OpenAI SDK 调用 Responses API。
- 推理强度可在 low 到 xhigh 之间设置,用 previous_response_id 继续对话,并添加 web_search 工具获取最新答案。
- 每个响应都会在 cost_in_usd_ticks 中给出确切价格,可选的内容准则可拒绝 nsfw、violence 或 profanity 类内容。
关于名称的说明:文档现在把公司称为 SpaceXSI,但这项服务仍叫 “the xAI API”,地址仍是 api.x.ai,密钥变量也仍是 XAI_API_KEY。
准备工作
- 一个已充值的 console.x.ai 账户。快速入门要求在使用 API 之前先充值。
- 一个装有
curl的终端。完成整篇教程只需要它。 - 可选:如果想在代码中调用 API,准备好带
pip的 Python,或带npm的 Node.js。
Grok 4.7 一览
以下数据来自 Grok 4.7 页面和价格页面,截至 2026 年 11 月 15 日。价格会变动,做预算前请先核实。
| 属性 | 数值 |
|---|---|
| 模型名称 | grok-4.7 |
| 上下文窗口 | 500,000 个 token |
| 知识截止日期 | 2026 年 5 月 |
| 输入 | 文本和图片 |
| 输出 | 文本 |
| 价格(提示词少于 200k token) | 每 100 万 token:输入 $2.00,缓存输入 $0.50,输出 $6.00 |
| 价格(提示词 200k token 及以上) | 每 100 万 token:输入 $4.00,缓存输入 $1.00,输出 $12.00 |
| 推理强度 | low、medium、high(默认)或 xhigh |
数字速览
500,000 个 token上下文窗口
$2.00每 100 万输入 token(200k 以下)
$6.00每 100 万输出 token(200k 以下)
第 1 步:创建 API 密钥
- 登录 console.x.ai 并充值。
- 打开 API Keys 页面,创建一个密钥。
- 把它保存到环境变量中,这样它永远不会出现在代码里:
export XAI_API_KEY="your_api_key"
在 Windows PowerShell 中,请改用 $env:XAI_API_KEY="your_api_key"。像对待密码一样保管密钥,不要粘贴到共享文档中,也不要提交到代码仓库。
第 2 步:用 curl 发送第一个请求
文档推荐使用 Responses API,地址为 https://api.x.ai/v1/responses。下面是快速入门中的示例:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.7",
"input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"
}'
预期结果:一个 JSON 对象。答案位于 output 列表中类型为 message 的条目里,其内容类型为 output_text。同一对象中还有一个 id(第 5 步会用到)和一个包含 token 数量的 usage 块。

第 3 步:从 Python 或 JavaScript 调用
只要把 OpenAI SDK 指向 xAI 的基础 URL,API 就能直接使用。任选其一安装:
pip install openai
npm install openai
Python:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
response = client.responses.create(
model="grok-4.7",
input="Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
)
print(response.output_text)
JavaScript(保存为 .mjs 文件,这样 import 和顶层 await 才能在 Node.js 中运行):
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.XAI_API_KEY,
baseURL: 'https://api.x.ai/v1',
});
const response = await client.responses.create({
model: 'grok-4.7',
input: 'Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}',
});
console.log(response.output_text);
两者都只输出模型返回的文本。xAI 还有自己的 Python 包(pip install xai-sdk),文档表示两者可以混用。
第 4 步:选择模型的思考深度
Grok 4.7 在回答前总会先推理。这一点无法关闭,但可以按照推理指南设置推理强度。默认值是 high。简单快速的调用用 low,最难的问题用 xhigh,前提是可以接受更慢的回答。
curl https://api.x.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-m 3600 \
-d '{
"model": "grok-4.7",
"reasoning": {"effort": "low"},
"input": "Summarise the difference between TCP and UDP in three bullet points."
}'
-m 3600 参数让请求最长运行一小时,curl 才会放弃。文档在推理示例中使用它,因为深度推理可能需要一段时间。在 Python 中,相同的设置写作 reasoning={"effort": "low"}。

第 5 步:无需重发整段对话即可追问
根据文本生成指南,Responses API 默认会把每次交互在 xAI 服务器上保存 30 天。因此,只需传入上一次响应的 id,就能继续对话:
curl https://api.x.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-m 3600 \
-d '{
"model": "grok-4.7",
"previous_response_id": "The previous response ID",
"input": [
{
"role": "user",
"content": "How do stars form?"
}
]
}'
把占位符替换成你上一次响应中的 id。如果不希望请求被保存,可在请求中加上 "store": false,自行保存历史记录。
你知道吗?
Responses API 默认会把每次交互在 xAI 服务器上保存 30 天。如果你想自己保存对话记录,可在请求中加上 “store”: false。
第 6 步:让 Grok 联网搜索
模型页面说得很直白:没有搜索工具,Grok 只知道训练数据里的内容。想获得最新答案,就加上联网搜索工具:
curl https://api.x.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-d '{
"model": "grok-4.7",
"input": [
{
"role": "user",
"content": "What were the main technology headlines this week?"
}
],
"tools": [
{
"type": "web_search"
}
]
}'
搜索次数由 Grok 自行决定。截至 2026 年 11 月 15 日,联网搜索在正常 token 费用之外按每 1,000 次调用 $5 收费,所以需要大量检索的提示词比普通提示词更贵。
第 7 步:查看每个请求的费用
每个响应都会在名为 cost_in_usd_ticks 的字段中给出确切价格,详见费用追踪指南。1 美元等于 10,000,000,000 tick。如果你装了 jq,下面的命令会输出单次调用的数值:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.7",
"input": "Say hello"
}' | jq '.usage.cost_in_usd_ticks'
把结果除以 10,000,000,000 就是美元金额。文档自己的例子:37756000 tick 约等于 $0.0038。
你知道吗?
xAI 以 tick 为单位计价:1 美元等于 10,000,000,000 tick。文档示例中的 37756000 tick 约合 $0.0038。
第 8 步(可选):添加内容准则
2026 年 10 月,xAI 推出了自定义审核控制。你在请求中附上一个 guidelines 列表,Grok 在生成时就会拒绝这类内容。共有三个类别:nsfw、violence 和 profanity,目前唯一可用的行为是 decline。
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.7",
"input": "Write a short story about a knight.",
"guidelines": [
{ "type": "policy", "category": "violence", "behavior": "decline" },
{ "type": "policy", "category": "nsfw", "behavior": "decline" }
]
}'
准则只对携带它的那个请求生效,所以每次都要发送。使用 OpenAI Python SDK 时,要把列表放在 extra_body 中传入,因为该 SDK 没有自己的 guidelines 参数。
常见错误与解决方法
下面的状态码来自 xAI 的调试页面以及上文链接的各篇指南。
| 你看到的情况 | 可能原因 | 解决方法 |
|---|---|---|
401 Unauthorized | 没有授权请求头,或密钥无效 | 发送 Authorization: Bearer <your key>,并用 echo $XAI_API_KEY 检查变量是否已设置 |
400 Bad Request | 请求体或 URL 中有无效参数,或 API 密钥不正确 | 检查 JSON、端点地址和密钥 |
403 Forbidden | 你的密钥或团队没有权限,或已被封禁 | 向团队管理员申请权限 |
404 Not Found | 找不到请求中的模型,或 URL 拼写错误 | 检查拼写 grok-4.7 和端点地址 |
415 Unsupported Media Type | 请求体为空,或缺少 Content-Type: application/json 请求头 | 添加该请求头和有效的请求体 |
422 Unprocessable Entity | 某个字段格式无效,例如未知的 guidelines 类别 | 对照文档检查该字段。对于准则,错误信息会列出有效值 |
429 Too Many Requests | 触发了速率限制 | 放慢速度,并以逐渐增加的间隔重试。限额会随团队总支出自动提高 |
设置 stop、presence penalty 或 frequency penalty 时报错 | 推理模型不接受这些参数 | 删除这些参数 |
| 请求超时 | 推理时间超出了客户端允许的时长 | 调高客户端超时时间(文档示例使用 3,600 秒),或降低推理强度 |
如果所有请求同时失败,先查看 status.x.ai,再去调试自己的代码。
总结
现在你已经有了可用的密钥、第一个请求,以及大多数项目都需要的五项设置:推理强度、保存的对话、联网搜索、单次请求费用和内容准则。文档还介绍了流式输出、结构化输出、文件上传和函数调用。
如果你在比较不同服务商,我们的 Gemini 4 Hydrogen API 教程用同样的步骤介绍了 Google 的模型。如果你更想把一切都留在自己的电脑上,请看如何用 Ollama 在本地运行模型。如果你想在通话而不是代码里用 Grok,这里介绍了如何把 Grok 加入 Zoom、Google Meet 或 Teams。
常见问题
Grok 4.7 API 多少钱?
提示词少于 200k token 时,每 100 万 token 输入 $2.00、缓存输入 $0.50、输出 $6.00。200k token 及以上的提示词价格翻倍。联网搜索每 1,000 次调用另收 $5。价格截至 2026 年 11 月 15 日。
可以用 OpenAI SDK 调用 Grok API 吗?
可以。把 Python 或 JavaScript 版 OpenAI SDK 指向基础 URL https://api.x.ai/v1,填入你的 XAI_API_KEY,然后用模型 grok-4.7 调用 responses.create。xAI 也有自己的 xai-sdk 包,文档表示两者可以混用。
为什么我的 Grok API 请求会超时?
Grok 4.7 在回答前总会先推理,而深度推理可能需要一段时间。调高客户端超时时间(文档示例使用 3,600 秒),或降低推理强度。
Grok 4.7 可以关闭推理吗?
不可以。Grok 4.7 在回答前总会先推理。你只能把推理强度设为 low、medium、high 或 xhigh,默认是 high。
小测验
Grok 4.7 的默认推理强度是什么?
- low(低)
- medium(中)
- high(高)
推理指南将 high 设为默认值。
多少 tick 等于 1 美元?
- 10,000,000,000
- 1,000,000
- 37,756,000
费用追踪指南指出,1 美元等于 10,000,000,000 tick。
401 Unauthorized 错误通常意味着什么?
- 触发了速率限制
- 缺少请求头或密钥无效
- 模型名称拼写错误
xAI 的调试页面列出的原因是没有授权请求头或密钥无效。
资料来源
链接最后核对于 2026 年 11 月 15 日。





写评论