GeiliAPI 接入手册

Grok CLI

把 Grok CLI 接到本站

本教程里说的 Grok CLI，是 xAI 官方命令行，只负责对话，不能出图或出视频。把推理地址改到本站，用 API Key，不要 grok login 登录 xAI 官方会话，否则请求仍会走 api.x.ai。

开始前

先创建 Grok 分组 的密钥。Base URL 填 https://sub.geiliapi.com/v1。要生图或生视频请改走 Grok 生图 / 生视频，并创建 Grok（Heavy） 密钥。档位看控制台和 模型价格。

安装

macOS / Linux

Terminal
curl -fsSL https://x.ai/cli/install.sh | bash
grok --version

也可 npm install -g @xai-official/grok。

Windows

PowerShell
irm https://x.ai/cli/install.ps1 | iex
grok --version

也可 npm install -g @xai-official/grok。

配置

最快的方式是设环境变量。设置后，Grok CLI 会从 {base}/models 拉模型列表，并用 Bearer Key 发请求，不再走官方登录。

Terminal
export GROK_MODELS_BASE_URL="https://sub.geiliapi.com/v1"
export XAI_API_KEY="替换为你的 Grok 分组 API Key"
export GROK_DEFAULT_MODEL="grok-4.6"
grok

长期使用建议写 ~/.grok/config.toml（Windows 为 %USERPROFILE%\.grok\config.toml）。密钥用环境变量，不要写进文件。

TOML
[endpoints]
models_base_url = "https://sub.geiliapi.com/v1"

[models]
default = "grok-4.6"

[model."grok-4.6"]
model = "grok-4.6"
base_url = "https://sub.geiliapi.com/v1"
name = "GeiliAPI Grok 4.6"
env_key = "XAI_API_KEY"
api_backend = "chat_completions"

写完后执行 grok inspect，确认 models_base_url 指向本站。若仍显示 api.x.ai，先 grok logout 或删掉 ~/.grok/auth.json，避免官方会话覆盖 Key。

默认 grok-4.6。分组里只有 4.5 时改成 grok-4.5。本站 Grok 走 Chat Completions，api_backend 不要写成 responses 或 messages。

提示

一键配置工具不覆盖 Grok CLI。

验证第一次请求

  1. 1

    检查实际地址

    执行 grok inspect，确认 models_base_url 是 https://sub.geiliapi.com/v1，不是 api.x.ai。

  2. 2

    跑一句最小任务

    执行 grok -p "只回复 OK"，再到控制台「使用记录」核对 Grok 分组 Key 和 grok-4.6。

这个工具的故障

inspect 仍显示 api.x.ai

先 grok logout 或删掉 ~/.grok/auth.json，再设 GROK_MODELS_BASE_URL 与 XAI_API_KEY。不要 grok login。

401 或模型列表为空

Key 必须是 Grok 分组。环境变量名是 XAI_API_KEY，不要把 Key 写进 config.toml。

协议报错

本站 Grok 走 Chat Completions，api_backend 必须是 chat_completions，不要写成 responses 或 messages。

下一步：要出图或出视频，换 Grok（Heavy）密钥并看生图教程。

Grok 生图 / 生视频 选模型 地址怎么填
已复制