INTEGRATION GUIDE

Grok Build 自定义模型：api_backend 选择与 inspect 验证

2026-09-30接入文档

依据 xAI 官方 Grok Build 文档配置自定义模型条目，显式选择 Responses、Chat Completions 或 Messages，使用 inspect 与短请求分层验证。

内容复核中 官方配置已核对；本站接入未实测。图解为本站原创示意，不是客户端运行截图。

查看教程占位服务地址

控制台: https://80321.cn
创建 Key: https://80321.cn/keys
钱包充值: https://80321.cn/wallet
文档站: https://80321.cn/docs.html

以上服务地址仅为教程占位示例，不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。

本页目录

Grok Build 原创接入配置示意，非真实运行截图

官方 Grok Build 与社区 CLI 分开看

xAI 官方 Grok Build 是可在 TUI、无头脚本和 ACP 集成中使用的编码 Agent，官方命令为 grok。本文只讨论这一产品；同名社区包的环境变量与存储位置不能直接套用。

它的用户配置位于 ~/.grok/config.toml。官方允许自定义模型，并提供 grok inspect 查看当前目录发现的配置、指令、插件、hooks 和 MCP 等来源。先看来源，比直接让 Agent 处理整个仓库更容易排除隐藏配置。

显式写清推理协议

[model.<id>] 定义单个模型，model 是发送给 API 的标识，base_url 是入口，env_key 指定取钥变量。api_backend 可选择 chat_completions、responses 或 messages。

以下是 Responses 路线的局部示意。Base URL 仅为占位示例，本站没有供本文实际调用的接口，真实协议、模型和凭证须另行确认。

[model.80321-example]
model = "YOUR_MODEL_ID"
name = "80321-example"
base_url = "https://80321.cn/v1"
env_key = "XAI_API_KEY"
api_backend = "responses"

[models]
default = "80321-example"

不要把“OpenAI 兼容”当成单一格式。协议选择应与服务规格一致，模型条目名称与 API 模型 ID 也不是同一个值。官方还列出工具调用流式开关和模型能力字段；没有依据时保留默认，不冒填能力标记。

从 inspect 到短回答

确认正式参数后，可按官方入口完成下面的最小检查；命令在本文没有执行。

export XAI_API_KEY="YOUR_API_KEY"
grok inspect
grok -p "只返回 OK，不读取仓库、不执行命令"   -m 80321-example --output-format json

inspect 用于解释加载来源，不等于网络验收。第二步只看终态、实际模型错误及文本响应。检查输出时仍应脱敏，不把配置中可能存在的认证值或敏感路径公开。

不同阶段的失败各有查法

如果模型条目不可选，先查配置位置、条目 ID 和被禁用模型规则；这些规则由模型配置控制。如果选到了模型但认证失败，核对 env_key 对应变量是否进入当前进程。路径或解析错误则回到 api_backend 与地址组合，不混改采样参数。

开始流式回答后卡住，可以核对服务端事件、工具调用流式能力和空闲超时设置。 ACP 是客户端集成协议，不是替代推理服务的 Base URL；grok agent stdio 与 HTTP 模型入口应分别验收。

supports_backend_search 描述上游是否支持 Grok 服务端搜索工具。新端点没有能力说明时，不要复制已启用的标志。客户端搜索与服务端搜索应分开检查；重试和超时也一次只调整一个值，先记录响应是否持续返回，再判断是否需要改变等待策略。

审批与沙箱要分别安排

官方说明，审批决定哪些工具可执行，沙箱限制批准后能访问的文件和网络。不要为了通过接口检查启用 --always-approve。第一次只验证文本，后续在隔离目录逐项增加能力。本文 verified 仅表示官方配置方式已核对，没有安装或运行 Grok Build，也不承诺示例上游的模型、成本或可靠性。