Clientes/Grok CLI
Usa la API de Wokey con Grok CLI
Obtén una clave de API de Wokey, apunta Grok CLI a la base URL de Wokey y confirma la conexión con una solicitud curl.
Actualizado
En esta páginaexpand_more
Obtén una clave de API y la base URLlink
Todos los clientes usan la misma clave de API de Wokey y la misma base URL.
Crea una clave de API
Inicia sesión y crea una clave de la plataforma en la página API. Las claves de una misma cuenta comparten su saldo.
Crear clave de APIkeyUsa la base URL de Wokey
Configura como base URL del cliente el dominio del gateway; la configuración de abajo indica si hay que añadir /v1.
Configura el clientelink
Usa la configuración oficial de Grok CLI para conectarte a Wokey. Agrega una entrada de modelo grok-4.7 con su propio api_key; el api_key de una entrada de modelo tiene prioridad sobre la sesión de grok login, así que las solicitudes Responses van al gateway de 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" }
]
Formatos de API y base URLlink
Cuando un mismo cliente cambia de formato de API, puede cambiar si la base URL termina en /v1.
| Formato | Base URL | Úsalo para |
|---|---|---|
| OpenAI Responses | https://api.wokey.ai | Modelos GPT |
Dónde se configura: ~/.grok/config.toml
Verifica con curllink
Si el cliente muestra un error, primero descarta problemas con la clave y la base URL usando curl.
Grok CLI usa el formato OpenAI Responses de forma predeterminada. Si esta solicitud devuelve 200, la clave y la base URL son correctas. Reemplaza YOUR_API_KEY por tu clave antes de enviarla.
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
}'Errores y solución de problemaslink
Primero distingue los casos de autenticación, saldo, límite de tasa, disponibilidad del modelo y tiempo de espera del upstream.
invalid api key
La clave falta, está mal escrita, se eliminó, o los encabezados Authorization / x-api-key no coinciden.
insufficient balance
El saldo de la cuenta es demasiado bajo. Recarga antes de enviar más solicitudes.
model_denylisted / account_restricted
Las llamadas al modelo, o a todos los modelos de la cuenta, están pausadas tras infracciones repetidas. Consulta Tarifas por gestión de infracciones y restricciones.
request_blocked
Esta solicitud se bloqueó antes de llegar al upstream y no se cobra, por ejemplo el reenvío sin cambios de una solicitud que el modelo acaba de rechazar, o un usuario final pausado (X-End-User-Id). El mensaje de error indica qué está bloqueado; modifica la solicitud como indica o vuelve a intentarlo más tarde. Las demás solicitudes no se ven afectadas.
rate limited
El tráfico es demasiado frecuente. Vuelve a intentarlo más tarde o reduce la concurrencia. Si solo un modelo, o un usuario final (X-End-User-Id), sigue devolviendo 429, puede ser un límite temporal tras infracciones.
client disconnected
El cliente cerró la conexión antes de que terminara la respuesta (código downstream_aborted). Por defecto no se cobra. Cuando una cuenta acumula al menos 50 desconexiones del cliente en las últimas 24 horas y representan el 10% o más de sus solicitudes, las solicitudes desconectadas posteriores se cobran según el uso que informó el upstream: la entrada procesada, incluidas lecturas y escrituras de caché, y la salida solo si el upstream la contabilizó. Una desconexión antes de que el upstream informe cualquier uso sigue siendo gratis. La cuenta recibe un aviso cuando empieza el cobro, y el cobro se detiene automáticamente en menos de una hora cuando la tasa de desconexión vuelve a la normalidad. La causa habitual es un tiempo de espera del cliente o del proxy demasiado corto, o un programa que cancela solicitudes antes de que terminen.
upstream unavailable
El servicio del modelo upstream no está disponible temporalmente. Cambia de modelo o vuelve a intentarlo más tarde.
upstream timeout
Se agotó el tiempo de espera de la respuesta del upstream. Acorta el contexto, reduce max_tokens o vuelve a intentarlo.
upstream overloaded
El modelo upstream está sobrecargado temporalmente y Wokey ya reintentó por otras rutas (código upstream_overloaded). No tiene relación con tu saldo. Vuelve a intentarlo en breve o cambia de modelo.
Preguntas frecuenteslink
- ¿El base_url de Grok CLI debe terminar en /v1?
- No. Configura base_url como https://api.wokey.ai y api_backend como responses.
- Ya ejecuté grok login. ¿Las solicitudes igual van a Wokey?
- Sí. El api_key de una entrada de modelo tiene prioridad sobre la sesión de grok login, así que una entrada con su propio api_key envía las solicitudes a Wokey.
- ¿Dónde va la clave de API?
- En el campo api_key de la entrada del modelo en ~/.grok/config.toml, solo la clave. Se guarda ahí en texto plano, así que no compartas el archivo.