Grok 4.7 API 使用教程:用 curl、Python 和 JavaScript 一步步上手

创建 xAI API 密钥,向 Grok 4.7 发送第一个请求,再加上推理强度、追问、联网搜索、费用追踪和内容准则。

Graphic of a terminal window sending a request to a cloud and getting a reply, for a guide to the Grok 4.7 API

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 密钥

  1. 登录 console.x.ai 并充值。
  2. 打开 API Keys 页面,创建一个密钥。
  3. 把它保存到环境变量中,这样它永远不会出现在代码里:
终端
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 块。

流程图:从充值 xAI 额度、创建 API 密钥到读取 Grok 4.7 的第一个响应

第 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"}。

Grok 4.7 推理强度等级示意图,从 low 到 xhigh,其中 high 标为默认值

第 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 日。

作者:Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

关于 Mindloop Experience

评论

写评论

更多来自 Mindloop Experience

查看 Mindloop Experience 的全部文章

最多可以鼓掌 50 次。