GROK_TEXT_API

Grok 接入

建立 Grok Key 即可使用 Grok 4.6 與 Grok 4.5。請求一律走 https://api.bruceai.net/v1，由 BRUCEAI 認證與計費，費率請看價格頁。

Codex 使用標準的 HTTP Responses API；不提供 Responses WebSocket。

下方提供五種接入方式：Grok Build 官方終端機代理（推薦，約 1 分鐘完成）、用 CC Switch 圖形介面管理 Codex 客戶端、在 ZCode 新增自訂供應商、Codex CLI 手動寫設定檔，或任何 OpenAI 相容客戶端。五種方式接的是同一把 Key，選一種完成即可。

模型 ID

可以把這些模型 ID 複製到 config.toml、API request body，或任何需要填模型名稱的 OpenAI 相容客戶端。每一組模型都要用對應類型的 Key 才能呼叫。

Grok需使用 Grok Key

BEFORE YOU START

先準備 API 金鑰

1. 前往 API Key 頁面

登入後到 API Key 頁面建立或複製 API Key。金鑰格式像 sk-or-v1-xxxxxxxxxxxx，請把它當密碼保管。

建立 API Key

3. 確認 Base URL

https://api.bruceai.net/v1

Grok Build、Codex 與 OpenAI 相容客戶端都使用 https://api.bruceai.net/v1。

2. 依要用的模型建立對應的 Key

點「新增 API Key」，填一個你認得出來的名稱，再依照要呼叫的模型選擇 Key 的類型：

OpenAI Key: 可呼叫 gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna 與 gpt-5.5。支援 Codex、GitHub Copilot 與任何 OpenAI 相容客戶端。
Grok Key: 可呼叫 grok-4.6 與 grok-4.5。支援 Grok Build、Codex 與任何 OpenAI 相容客戶端。
DeepSeek Key: 可呼叫 deepseek-v4.1-flash：1M 上下文，支援思考模式、工具呼叫與圖片輸入。支援 Codex 與任何 OpenAI 相容客戶端。

一把 Key 只能呼叫自己這家供應商的模型：用 Grok Key 送 GPT 模型 ID，或用 OpenAI Key 送 grok-4.6，都會直接收到 400。要用多家模型就分別建立幾把 Key。

不要把 API 金鑰發給別人，也不要提交到 GitHub、GitLab 或任何公開倉庫。

選擇接入方式

下方步驟會依照你選擇的方式切換。

xAI 官方終端機編碼代理，裝好後貼一段設定即可，約 1 分鐘完成。

先選擇你的系統

下方所有指令會依照你選擇的系統切換。

STEP 01

建立 Grok Key

登入 BRUCEAI，進入「API Key 管理」，點「新增 API Key」，類型選擇「Grok」。

完整金鑰只會顯示一次，請先複製下來再關閉視窗。

STEP 02

安裝 Grok Build

安裝完成後關掉終端機重開一個新視窗，再執行 grok --version 確認裝好了。

macOS / Linux

bash

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

STEP 03

打開設定檔

設定檔在 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。

STEP 04

貼上這段設定

把下面這段貼進去，只需要把金鑰換成你自己的 Grok Key。檔案裡原有的 [marketplace]、[ui] 等設定保留即可，不要整份覆蓋。

toml

[models]
default = "bruceai-grok"
web_search = "bruceai-grok"

[model.bruceai-grok]
model = "grok-4.6"
name = "Grok (BRUCEAI)"
base_url = "https://api.bruceai.net/v1"
api_key = "sk-or-v1-你的金鑰"
api_backend = "responses"
context_window = 500000

[ui]
fork_secondary_model = "bruceai-grok"

bruceai-grok 只是本機別名，[models].default 必須指向它；真正送出的模型是 model = "grok-4.6"（也可以填 grok-4.5）。base_url 結尾的 /v1 不可省略。

STEP 05

清掉官方登入並測試

Grok Build 會優先使用瀏覽器登入留下的 session，不先登出就會一直跳登入頁。執行下面這組指令，最後一行是測試。

直接回覆 OK 且沒有跳出瀏覽器登入，就代表已經走 BRUCEAI。

macOS / Linux

bash

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

STEP 06

進入專案開始使用

切換到你的專案目錄，執行 grok 進入介面。

右下角顯示「Grok (BRUCEAI)」與「Logged in with API key」，就代表正在走 BRUCEAI；也可以輸入 /model 再確認一次。

Grok Build

bash

grok

STEP 07

常見問題

還是一直要登入：確認已執行 grok logout、auth.json 已刪除，並且 [models].default 指向 bruceai-grok；專案目錄下若有 .grok/config.toml 會蓋過使用者設定。

401 / invalid token：金鑰不完整、有多餘空白，或不是 Grok Key。

400 / unsupported_model：model 只能填 grok-4.6 或 grok-4.5。

404：base_url 結尾要是 /v1，不是 https://api.bruceai.net。

子任務又跳官方登入：確認 [ui] 裡的 fork_secondary_model 也填了 bruceai-grok。

回覆格式報錯：api_backend 先用 responses，仍不行再改成 chat_completions。