客户端接入/Grok CLI
在 Grok CLI 中使用 Wokey API
准备好 Wokey API Key，把 Grok CLI 的 Base URL 指向 Wokey，再用一条 curl 请求确认连通。
更新于
准备 API Key 与 Base URLlink
所有客户端都用同一个 Wokey API Key 和同一个 Base URL。
使用 Wokey Base URL
客户端的 Base URL 填网关域名，按下方配置决定是否追加 /v1。
配置客户端link
使用 Grok CLI 官方配置文件接入 Wokey。为 grok-4.7 写一个模型条目并直接填入 api_key；条目里的 api_key 优先于 grok login 的登录会话，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" }
]
协议与 Base URL 写法link
同一个客户端换协议时，Base URL 带不带 /v1 可能不同。
| 协议 | Base URL 写法 | 建议用于 |
|---|---|---|
| OpenAI Responses | https://api.wokey.ai | GPT 模型 |
配置位置: ~/.grok/config.toml
用 curl 验证link
客户端报错时，先用 curl 排除 Key 和 Base URL 的问题。
Grok CLI 默认使用 OpenAI Responses 协议。这条请求返回 200，说明 Key 和 Base URL 都正确；发送前把 YOUR_API_KEY 换成你的 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
Key 缺失、写错、已删除，或 Authorization / x-api-key 认证 Header 冲突。
insufficient balance
账户额度不足，需要充值后继续请求。
model_denylisted / account_restricted
该模型或整个账号因反复违规被暂停调用，处理方法见「违规处置费与风控限制」。
request_blocked
这个请求被拦截，没有发往上游，也不收费。例如原样重发刚被模型拒绝的请求，或某个终端用户（X-End-User-Id）被暂停。报错信息会说明拦截的范围；按提示修改请求或稍后再试，其他请求不受影响。
rate limited
请求过于频繁，稍后重试或降低并发。如果只有某一个模型或某一个终端用户（X-End-User-Id）持续返回 429，可能是违规后的临时限流。
client disconnected
客户端在响应完成前断开了连接（code 为 downstream_aborted），默认不收费。账号过去 24 小时的客户端断开达到 50 次、并且占全部请求的 10% 以上时，之后断开的请求会自动按上游报告的用量计费：已处理的输入（含缓存读写）照收，输出只在上游给出计数时才收；上游还没报告用量就断开的，仍然免费。开始计费时会通知账号；断开比例回到正常范围后，计费在一小时内自动停止。常见原因是客户端或代理的超时设得太短，或者程序在请求完成前主动取消了它。
upstream unavailable
上游模型服务暂不可用，通常可以切换模型或稍后重试。
upstream timeout
上游响应超时，建议缩短上下文、降低 max_tokens 或重试。
upstream overloaded
上游模型暂时过载，Wokey 已先换线路重试过（code 为 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 Key 写在哪里？
- 写在 ~/.grok/config.toml 对应模型条目的 api_key 字段，只填 Key 本身。Key 以明文保存在这个文件里，不要把文件分享给别人。