¿La URL base de Z Code debe terminar en /v1?

Depende del formato de API con el que te conectes. Para Anthropic usa https://api.wokey.ai sin /v1; para OpenAI usa https://api.wokey.ai/v1.

¿Por qué se ignoran las variables de entorno que exporté en una terminal?

Las variables de entorno de la terminal y la configuración de modelos de la app de escritorio de Z Code son independientes y no se sincronizan. Ingresa la URL base y la clave de API en el provider, en Settings → Model Settings.

Ya agregué el provider. ¿Por qué no puedo elegir un modelo?

Cada provider también necesita Add Model con un ID de modelo, y el interruptor de activación del modelo encendido, antes de que aparezca en la lista de modelos del cuadro de chat.

¿Qué hago si la salida se corta o el contexto es demasiado pequeño?

Abre Advanced en el modelo y ajusta Max output tokens y la ventana de contexto a los valores de la página del modelo. Un modelo recién agregado tiene una ventana de contexto predeterminada de 200000.

¿Dónde guarda Z Code esta configuración?

En ~/.zcode/v2/config.json. Respalda el archivo antes de cambiar de equipo o reinstalar; contiene tu clave de API, así que no lo compartas.

Clientes/Z Code

Usa la API de Wokey con Z Code

Obtén una clave de API de Wokey, apunta Z Code a la base URL de Wokey y confirma la conexión con una solicitud curl.

Actualizado 2026-11-10

En esta páginaexpand_more

Preparar
Configurar
Formatos
Verificar
Solución de problemas
Preguntas frecuentes

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 APIkey

Usa 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

Z Code agrega providers personalizados en su página de configuración y admite los formatos de API de Anthropic y de OpenAI. Usa el formato de Anthropic para los modelos Claude.

1
Abre la configuración de modelos
Haz clic en el nombre del modelo en el cuadro de chat → Manage Models, o ve a Settings → Model Settings.
2
Agrega el provider
Haz clic en Add Provider y nómbralo Wokey. Para el formato de Anthropic, configura Base URL como https://api.wokey.ai; para el formato de OpenAI, como https://api.wokey.ai/v1. Pega tu clave de API de Wokey en API Key.
3
Agrega y activa un modelo
Debajo del provider, haz clic en Add Model, ingresa un ID de modelo como claude-opus-5-5 y activa su interruptor.
4
Cambia de modelo
De vuelta en el cuadro de chat, elige el modelo que agregaste en la lista de modelos y envía un mensaje corto para confirmar.

Z Code

Provider name: Wokey
API format: Anthropic
Base URL: https://api.wokey.ai
API Key: YOUR_API_KEY
Model ID: claude-opus-5-5

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
Anthropic Messages	https://api.wokey.ai	Modelos Claude
OpenAI Chat Completions	https://api.wokey.ai/v1	DeepSeek, GLM, Kimi y otros modelos

Dónde se configura: Settings → Model Settings (archivo ~/.zcode/v2/config.json)

Verifica con curllink

Si el cliente muestra un error, primero descarta problemas con la clave y la base URL usando curl.

Z Code usa el formato Anthropic Messages 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

curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "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.

401

invalid api key

La clave falta, está mal escrita, se eliminó, o los encabezados Authorization / x-api-key no coinciden.

402

insufficient balance

El saldo de la cuenta es demasiado bajo. Recarga antes de enviar más solicitudes.

403

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.

403

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.

429

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.

499

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.

502

upstream unavailable

El servicio del modelo upstream no está disponible temporalmente. Cambia de modelo o vuelve a intentarlo más tarde.

504

upstream timeout

Se agotó el tiempo de espera de la respuesta del upstream. Acorta el contexto, reduce max_tokens o vuelve a intentarlo.

529

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

¿La URL base de Z Code debe terminar en /v1?: Depende del formato de API con el que te conectes. Para Anthropic usa https://api.wokey.ai sin /v1; para OpenAI usa https://api.wokey.ai/v1.
¿Por qué se ignoran las variables de entorno que exporté en una terminal?: Las variables de entorno de la terminal y la configuración de modelos de la app de escritorio de Z Code son independientes y no se sincronizan. Ingresa la URL base y la clave de API en el provider, en Settings → Model Settings.
Ya agregué el provider. ¿Por qué no puedo elegir un modelo?: Cada provider también necesita Add Model con un ID de modelo, y el interruptor de activación del modelo encendido, antes de que aparezca en la lista de modelos del cuadro de chat.
¿Qué hago si la salida se corta o el contexto es demasiado pequeño?: Abre Advanced en el modelo y ajusta Max output tokens y la ventana de contexto a los valores de la página del modelo. Un modelo recién agregado tiene una ventana de contexto predeterminada de 200000.
¿Dónde guarda Z Code esta configuración?: En ~/.zcode/v2/config.json. Respalda el archivo antes de cambiar de equipo o reinstalar; contiene tu clave de API, así que no lo compartas.