在 Grok CLI 中使用 Wokey API

准备好 Wokey API Key，把 Grok CLI 的 Base URL 指向 Wokey，再用一条 curl 请求确认连通。

vpn_key

准备 API Key 与 Base URL

所有客户端都用同一个 Wokey API Key 和同一个 Base URL。

创建 API Key

登录后在 API 页面创建平台 Key；同一账户下的 Key 共享余额。

创建 API Keykey

使用 Wokey Base URL

客户端的 Base URL 填网关域名，按下方配置决定是否追加 /v1。

terminal

配置客户端

按下面的配置把客户端的请求指向 Wokey。

Grok CLI

使用 Grok CLI 官方配置文件接入 Wokey。为 grok-4.7 写一个模型条目并直接填入 api_key；条目里的 api_key 优先于 grok login 的登录会话，Responses 请求会发送到 Wokey 网关。

Grok CLI

# ~/.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" }
]

task_alt

用 curl 验证

客户端报错时，先用 curl 排除 Key 和 Base URL 的问题。

Grok CLI 默认使用 OpenAI Responses 协议。这条请求返回 200，说明 Key 和 Base URL 都正确；发送前把 YOUR_API_KEY 换成你的 Key。

cURL

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
  }'

troubleshoot

错误与排障

先区分认证、额度、限流、模型不可用和上游超时。

401

invalid api key

Key 缺失、写错、已删除，或 Authorization / x-api-key 认证 Header 冲突。

402

insufficient balance

账户额度不足，需要充值后继续请求。

429

rate limited

请求过于频繁，稍后重试或降低并发。

502

upstream unavailable

上游模型服务暂不可用，通常可以切换模型或稍后重试。

504

upstream timeout

上游响应超时，建议缩短上下文、降低 max_tokens 或重试。

529

upstream insufficient quota

官方通道上游额度不足，等待路由恢复或切换可用模型。