Grok 4.7 API 怎么接？首次调用与多轮推理记录保留

自己的应用调用 Grok 4.7 时，公共 xAI API 使用的模型 ID 是 grok-4.7。接入变化不只是换名字：Responses 返回的加密推理条目，需要在后续传回对话历史时完整保留。

本文依据 2026 年 9 月 22 日核对的官方文档说明请求构造，不代表已经完成付费生产调用或性能测试。

先发一个最小 Responses 请求

按官方快速开始创建开发者 Key，确认账户余额，并在本地设置 XAI_API_KEY。不要把 Key 放进浏览器端代码或提交到仓库。

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4.7",
    "input": "Explain why Python list.sort() returns None."
  }'

接口和模型名来自官方模型指南。先发短文本请求，可以在加入工具、大文件或 Agent 框架前隔离账号与协议问题。

HTTP 成功只是第一步。还要检查是否返回预期答案及用量，再验证答案本身。合法的 API 响应不保证推理正确。

Python：保留完整输出条目

安装支持 Responses 的 OpenAI SDK，并在测试记录中保存版本。可用 python -m pip show openai 查看安装版本。

import os
from openai import OpenAI

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

history = [{
    "role": "user",
    "content": "Explain why Python list.sort() returns None.",
}]
first = client.responses.create(model="grok-4.7", input=history)
print(first.output_text)

# Preserve all items, including encrypted reasoning.
history.extend(item.model_dump(exclude_none=True) for item in first.output)
history.append({
    "role": "user",
    "content": "Show a version that sorts without mutating the input.",
})
second = client.responses.create(model="grok-4.7", input=history)
print(second.output_text)

不要只保存 first.output 中可见的答案文字。官方说明，Grok 4.7 会自动包含 reasoning.encrypted_content，即使请求没有显式设置 include。后续 input 应原样带回推理条目，不尝试解码或改写加密字段。

这个例子由客户端显式管理历史。移植到框架时，要检查框架实际保留和转发哪些字段，不能假设所有兼容封装都会保留服务商扩展字段。

Chat Completions 要按自己的格式处理

Responses 的加密字段变化，不意味着要把 Responses 输出对象直接塞进 Chat Completions 的 messages。请求哪个接口，就使用哪个接口的结构。已有应用采用 Chat Completions 时，可以先在原协议上验证新模型，再决定是否迁移。

尽量分开模型升级和协议迁移。否则一次失败可能来自适配器、对话历史或模型，很难定位。

推理与缓存设置要显式记录

模型支持 low、medium、high、xhigh，默认 high。做评估时记录档位；更高档位不保证完成任务的费用更低。

官方指南建议 Responses 使用 prompt_cache_key，Chat Completions 使用 x-grok-conv-id 请求头改善同一对话的路由。配置后仍要看真实缓存用量，不能把路由设置当成已命中缓存的证据。

根据失败环节排查

这些是诊断分类，不是本站复现的错误原句。修改多个设置前，先保存实际请求 ID 和错误。

运行长任务前，可按费用指南设预算。希望直接用客户端，则看入口指南区分 Cursor、Build 与 API 账号。