Claude 访客:新账户可在 30 天内获得 $1.00 API 赠送额度。每人限领一次,仅用于 API 用量。

GROK BUILD + RUNAPI

在 Grok Build 中使用 RunAPI。

Grok Build 支持通过 base_url 和 env_key 配置自定义模型。将文档规定的 TOML 结构指向 RunAPI,把密钥保存在 RUNAPI_API_KEY,并选择目录中的模型指南。

公开配置参考 · 不宣称真实运行或付费上游结果
[model.runapi]
model = "gpt-5.5"
name = "RunAPI GPT 5.5"
base_url = "https://runapi.ai/v1"
env_key = "RUNAPI_API_KEY"

[models]
default = "runapi"
export RUNAPI_API_KEY="runapi_xxx"
grok --version
grok
公开配置参考/v1
设置

配置文档规定的自定义模型结构

本页面将官方配置事实与运行证据分开。本次工作没有发起付费上游请求,也没有执行真实 Grok Build 会话,因此示例不代表推理成功。

1

在环境中设置 API 密钥

在启动 Grok Build 的同一环境中导出 RUNAPI_API_KEY。不要把真实密钥写入 config.toml 或源代码。

export RUNAPI_API_KEY="runapi_xxx"
2

添加 RunAPI 模型条目

使用 xAI 文档中的 model、name、base_url 和 env_key 字段,让 default 指向命名的模型条目。

[model.runapi]
3

在会话前本地检查

检查已安装的 CLI 版本并在本地查看生成的配置。本地检查不能证明 RunAPI 请求或模型响应成功。

grok --version
模型指南

为 Grok Build 选择 RunAPI 模型

指南列表来自 RunAPI 目录。每份指南展示当前模型 ID 和公开 endpoint,不代表每个目录变体都已在 Grok Build 中完成实际运行验证。

GROK BOT

Grok Bot 是由 Cursor 托管的独立产品。

xAI 将 Grok Bot 说明为连接 Cursor 的产品,Bot 在持久的云端电脑上运行。公开文档没有提供 Grok Build 所述的自定义 base_url 或模型选择器配置,因此本页不承诺 Grok Bot 通过 RunAPI 路由。

阅读官方 Grok Bot 文档
参考

配置字段

字段 值 用途
model.runapi.model gpt-5.5 为自定义条目选择 RunAPI 目录中的模型。
model.runapi.base_url https://runapi.ai/v1 将文档规定的 OpenAI 兼容 base URL 指向 RunAPI。
model.runapi.env_key RUNAPI_API_KEY 从环境变量读取凭据,避免硬编码。
models.default runapi 将命名的自定义模型条目设为默认值。
常见问题

Grok Build 配置问题

本页是否声称 Grok Build 已完成 RunAPI 推理?

不是。TOML 结构遵循 xAI 的公开 Grok Build 文档;真实 RunAPI 请求需要另行授权的运行时检查。本次工作没有发起付费请求。

RunAPI 密钥应该保存在哪里?

将 RUNAPI_API_KEY 设置在启动 Grok Build 的环境中。env_key 字段指定本地配置应读取的变量。

Grok Bot 能否把此配置用作自己的模型选择器?

没有这种声明。xAI 的 Grok Bot 文档描述由 Cursor 管理的模型,并未说明用户可控制的 base_url 或模型选择器。

使用模型目录中的指南

创建 RunAPI 帐户或登录,查看当前模型目录,并将运行验证与这份公开配置参考分开。