神稳AI
GROK_TEXT_API

Grok Heavy 接入

建立 API Key 时选择 Grok Heavy 专用通道,即可使用 Grok 4.7、Grok 4.6 与 Grok 4.5。请求统一经过 https://api.shenwenai.com/v1,由神稳AI进行认证与计费。

Codex 使用标准 HTTP Responses API;本通道不启用 Responses WebSocket。

下方提供四种配置方式:Grok Build 官方终端代理(推荐,约 1 分钟完成)、用 CCSwitch 图形界面管理 Codex 客户端、在 ZCode 新增自定义供应商(推荐),或直接用 Codex CLI 手动写配置文件。四种方式接的是同一个通道,选一种完成即可。

支持模型 ID

可以把这些模型 ID 复制到 config.toml、API request body,或任何需要填写模型名称的 OpenAI 兼容客户端。每个模型只能用对应通道的金钥调用。

API_KEY_REQUIRED

先准备 API 金钥

1. 前往个人页面

登录后到个人页面建立或复制 API Key。金钥长得像 sk-or-v1-xxxxxxxxxxxx,请当密码保管。

前往个人页面

2. 新增 API Key 并选择通道

点击「新增 API Key」,输入便于辨识的名称,再根据用途选择通道:

GPT Pro 通道 · 0.22x(Pro 号池)
优先稳定性,支持 OpenAI(Codex 接入)与 OpenAI 兼容。适合长时间运行及重要文字任务。
GPT 低价通道 · 0.09x(Plus 号池)
优先价格,支持 OpenAI(Codex 接入)与 OpenAI 兼容。适合日常开发、学习、测试,以及更重视成本的文字任务。
国产 DeepSeek V4.1 Flash · 官方价 6 折
只提供 deepseek-v4.1-flash,1M 上下文,支持思考模式、工具调用与图片输入。支持 OpenAI(Codex 接入)与 OpenAI 兼容。
DeepSeek 通道 · 官方价 8.5 折 / 6.5 折
提供 deepseek-v4-flash 与 deepseek-v4-pro。支持 OpenAI(Codex 接入)、OpenAI 兼容与 CC 接入。

CC 接入只能使用 Claude 通道或 Grok 通道的金钥,GPT Pro 通道与破限通道会直接收到 403。生图请另外选择 OpenAI 生图 Key 或 Grok 生图 Key;文字与生图用途不能混在同一把 Key,需要多个用途时请分别建立。

新增 API Key 窗口,显示 GPT Pro、GPT 低价与 Grok 通道选择
新增 API Key 时,先选择通道,再确认该金钥需要的支持功能。

3. 确认 Base URL

Codex 与 OpenAI 兼容客户端都使用 https://api.shenwenai.com/v1。

https://api.shenwenai.com/v1

不要把 API 金钥发给别人,也不要提交到 GitHub、GitLab 或任何公开仓库。

选择配置方式

下方步骤会根据你选择的方式切换。

xAI 官方终端编码代理,装好后贴一段配置即可,约 1 分钟完成。

先选择你的系统

下方指令会根据你选择的系统切换。

建立 Grok Heavy API Key

登录神稳AI,进入「API Key 管理」,点击「新增 API Key」,通道选择「Grok Heavy · 官方价 0.15 倍」。

完整金钥只会显示一次,请先复制下来再关闭窗口。

安装 Grok Build

安装完成后关掉终端重开一个新窗口,再执行 grok --version 确认装好了。

macOS / Linux
bash
curl -fsSL https://x.ai/cli/install.sh | bash

打开配置文件

配置文件在 macOS / Linux 是 ~/.grok/config.toml,Windows 是 %USERPROFILE%\.grok\config.toml。

macOS / Linux
bash
mkdir -p ~/.grok
nano ~/.grok/config.toml

nano 保存方式:Ctrl+O、Enter、Ctrl+X。

贴上这段配置

把下面这段贴进去,只需要把金钥换成你自己的。文件里原有的 [marketplace]、[ui] 等设置保留即可,不要整份覆盖。

toml
[models]
default = "shenwen-grok"
web_search = "shenwen-grok"

[model.shenwen-grok]
model = "grok-4.6"
name = "Grok (ShenwenAI)"
base_url = "https://api.shenwenai.com/v1"
api_key = "sk-or-v1-你的金钥"
api_backend = "responses"
context_window = 500000

[ui]
fork_secondary_model = "shenwen-grok"

shenwen-grok 只是本机别名,[models].default 必须指向它;真正送出的模型是 model = "grok-4.6"(也可以填 grok-4.7 或 grok-4.5)。base_url 结尾的 /v1 不可省略。

清掉官方登录并测试

Grok Build 会优先使用浏览器登录留下的 session,不先登出就会一直跳登录页。执行下面这组指令,最后一行是测试。

直接回覆 OK 且没有跳出浏览器登录,就代表已经走神稳AI通道。

macOS / Linux
bash
grok logout
rm -f ~/.grok/auth.json
grok -p "只回覆 OK"

进入项目开始使用

切换到你的项目目录,执行 grok 进入界面。

右下角显示「Grok (ShenwenAI)」与「Logged in with API key」,就代表正在走神稳AI通道;也可以输入 /model 再确认一次。

Grok Build 启动画面,右下角显示 Grok (ShenwenAI) 与 Logged in with API key
看到右下角的 Grok (ShenwenAI) 就配置完成了。
Grok Build
bash
grok

常见问题

还是一直要登录:确认已执行 grok logout、auth.json 已删除,并且 [models].default 指向 shenwen-grok;项目目录下若有 .grok/config.toml 会盖过使用者设置。

401 / invalid token:金钥不完整、有多余空白,或不是 Grok Heavy 通道的金钥。

400 / unsupported_model:model 只能填 grok-4.7、grok-4.6 或 grok-4.5。

404:base_url 结尾要是 /v1,不是 https://api.shenwenai.com。

子任务又跳官方登录:确认 [ui] 里的 fork_secondary_model 也填了 shenwen-grok。

回覆格式报错:api_backend 先用 responses,仍不行再改成 chat_completions。