用戶端/Grok CLI
在 Grok CLI 中使用 Wokey API
取得 Wokey API 金鑰，將 Grok CLI 的 Base URL 指向 Wokey，再用一個 curl 請求確認連線。
更新於
準備 API 金鑰與 Base URLlink
所有用戶端都使用同一組 Wokey API 金鑰和同一個 Base URL。
使用 Wokey Base URL
用戶端的 Base URL 填入閘道網域；是否加上 /v1 請參考下方設定。
設定用戶端link
使用 Grok CLI 的官方設定接入 Wokey。新增一個帶有自己 api_key 的 grok-4.7 模型項目；模型項目中的 api_key 優先於 grok 的登入工作階段，因此 Responses 請求會送到 Wokey 閘道。
# ~/.grok/config.toml
[models]
default = "grok-4.7"
[model."grok-4.7"]
model = "grok-4.7"
name = "Grok 4.7 via Wokey"
base_url = "https://api.wokey.ai"
api_backend = "responses"
api_key = "YOUR_API_KEY"
context_window = 500000
supports_reasoning_effort = true
reasoning_effort = "high"
reasoning_efforts = [
{ value = "low", label = "Low" },
{ value = "medium", label = "Medium" },
{ value = "high", label = "High" },
{ value = "xhigh", label = "Extra High" }
]
API 格式與 Base URLlink
同一個用戶端切換 API 格式時，Base URL 結尾是否帶 /v1 可能不同。
| 格式 | Base URL | 適用於 |
|---|---|---|
| OpenAI Responses | https://api.wokey.ai | GPT 模型 |
設定位置: ~/.grok/config.toml
用 curl 驗證link
用戶端回報錯誤時，先用 curl 排除金鑰與 Base URL 的問題。
Grok CLI 預設使用 OpenAI Responses 格式。這個請求回傳 200，代表金鑰和 Base URL 都正確；送出前請把 YOUR_API_KEY 換成你的金鑰。
curl https://api.wokey.ai/v1/responses \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"instructions": "You are a helpful assistant.",
"input": [
{ "role": "user", "content": "Hello" }
],
"store": false,
"stream": false
}'錯誤與疑難排解link
先區分認證、餘額、限流、模型無法使用與上游逾時等情況。
invalid api key
金鑰缺少、輸入錯誤、已刪除，或 Authorization 與 x-api-key 標頭內容衝突。
insufficient balance
帳號餘額不足。請先儲值再繼續送出請求。
model_denylisted / account_restricted
因重複違規，對該模型或帳號下所有模型的呼叫已被暫停。請參閱「違規處理費與限制」。
request_blocked
這個請求在送達上游前就被攔截，不會計費，例如原封不動地重送模型剛拒答的請求，或來自已暫停的終端使用者（X-End-User-Id）。錯誤訊息會說明被攔截的原因；請依訊息修改請求或稍後重試。其他請求不受影響。
rate limited
請求過於頻繁。請稍後重試或降低並行數。若只有某一個模型或某一個終端使用者（X-End-User-Id）持續回傳 429，可能是違規後的暫時限制。
client disconnected
用戶端在回應完成前關閉了連線（代碼 downstream_aborted）。預設不收費。當帳號在過去 24 小時內至少有 50 次用戶端中斷，且占其請求的 10% 以上時，之後中斷的請求會依上游回報的用量計費：已處理的輸入（含快取讀取與寫入），以及僅在上游有計入時的輸出。在上游回報任何用量之前就中斷的請求仍然免費。開始計費時會通知帳號，中斷率恢復正常後一小時內會自動停止計費。常見原因是用戶端或代理的逾時設定太短，或程式在請求完成前就取消了請求。
upstream unavailable
上游模型服務暫時無法使用。請切換模型或稍後重試。
upstream timeout
上游回應逾時。請縮短上下文、調低 max_tokens 或重試。
upstream overloaded
上游模型暫時過載，Wokey 已經在其他路由上重試過（代碼 upstream_overloaded）。這與你的餘額無關。請稍後重試或切換模型。
常見問題link
- Grok CLI 的 base_url 要不要加 /v1？
- 不用，base_url 填 https://api.wokey.ai，api_backend 填 responses。
- 已經執行過 grok login，請求還會送到 Wokey 嗎？
- 會。模型條目中的 api_key 優先於 grok login 的登入工作階段，所以帶有 api_key 的條目會把請求送到 Wokey。
- API 金鑰要寫在哪裡？
- 寫在 ~/.grok/config.toml 對應模型條目的 api_key 欄位，只填金鑰本身。金鑰以明文儲存在這個檔案裡，請不要分享這個檔案。