Clientes/opencode
Usa la API de Wokey con opencode
Obtén una clave de API de Wokey, apunta opencode 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
Un solo comando escribe el provider de Wokey y cambia el modelo predeterminado a wokey/auto.
export WOKEY_API_KEY="YOUR_API_KEY"
curl -fsSL https://wokey.ai/downloads/opencode/install.sh | sh
opencodeFormatos 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 Chat Completions | https://api.wokey.ai | DeepSeek, GLM, Kimi y otros modelos |
Dónde se configura: ~/.config/opencode/opencode.json
Verifica con curllink
Si el cliente muestra un error, primero descarta problemas con la clave y la base URL usando curl.
opencode usa el formato OpenAI Chat Completions 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/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'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
- ¿Qué cambia el script de instalación?
- Agrega un provider llamado wokey a ~/.config/opencode/opencode.json y establece el modelo predeterminado en wokey/auto. Si ya existe el archivo, primero se respalda como opencode.json.bak, y se conservan los demás providers que contiene.
- ¿Puedo evitar poner la clave de API en el comando?
- Ejecuta el script sin definir WOKEY_API_KEY y te pedirá la clave en la terminal sin mostrarla. La clave se guarda en opencode.json, así que no compartas ese archivo.
- ¿Cómo uso un modelo específico?
- Define WOKEY_MODEL antes de ejecutar el script, por ejemplo export WOKEY_MODEL=claude-opus-5-5, y el modelo predeterminado pasa a ser wokey/claude-opus-5-5. Sin él, el script usa auto.