Clientes/WorkBuddy

Usa la API de Wokey con WorkBuddy

Obtén una clave de API de Wokey, apunta WorkBuddy 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 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

WorkBuddy usa OpenAI Chat Completions para modelos personalizados. En WorkBuddy, abre Settings → Model → Custom models e ingresa el endpoint de Wokey, tu clave de API y deepseek-v4.1-flash; así las tareas y los flujos de agentes de WorkBuddy pueden usar llamadas a herramientas y entrada de imágenes.

  1. 1

    Abre la configuración de modelos

    Haz clic en el botón de cuenta en la esquina inferior izquierda de WorkBuddy → Settings → Model. También puedes abrir el selector de modelos y elegir Configure custom model.

  2. 2

    Agrega un modelo personalizado

    Elige Custom. Configura el endpoint como https://api.wokey.ai, pega tu clave de API de Wokey e ingresa el ID exacto del modelo deepseek-v4.1-flash (el ID antiguo deepseek-flash también funciona).

  3. 3

    Configura las capacidades

    Activa las llamadas a herramientas y la entrada de imágenes. Deja desactivados el modo de razonamiento y el protocolo personalizado. deepseek-v4.1-flash acepta texto, imágenes y herramientas; si usas deepseek-v4-flash, desactiva la entrada de imágenes porque ese modelo solo admite texto.

  4. 4

    Guarda y cambia de modelo

    Ejecuta Test connection, guarda el modelo y selecciónalo en el selector de modelos de la conversación. Empieza con un prompt de texto corto antes de probar herramientas o imágenes.

WorkBuddy
Provider: Custom
Endpoint: https://api.wokey.ai
API key: YOUR_API_KEY
Model: deepseek-v4.1-flash
Tool calling: On
Image input: On
Reasoning mode: Off
Custom protocol: Off

Formatos de API y base URLlink

Cuando un mismo cliente cambia de formato de API, puede cambiar si la base URL termina en /v1.

FormatoBase URLÚsalo para
OpenAI Chat Completionshttps://api.wokey.aiDeepSeek, GLM, Kimi y otros modelos

Dónde se configura: Settings → Models → Custom models

Solución de problemas comuneslink

  • 404: deja el endpoint en https://api.wokey.ai y el protocolo personalizado desactivado. Solo con el protocolo personalizado activado debes ingresar la ruta completa https://api.wokey.ai/v1/chat/completions.
  • 401: pega la clave tal cual en el campo API key; no agregues el prefijo Bearer. Confirma que la clave esté activa y que la cuenta tenga saldo.
  • model_not_found: configura el ID del modelo como deepseek-v4.1-flash, sin espacios ni sufijos adicionales.
  • Fallan las solicitudes con imágenes: selecciona deepseek-v4.1-flash y activa la entrada de imágenes. deepseek-v4-flash solo acepta texto.
  • 429, 502, 504 o 529: reduce la concurrencia, acorta el contexto o vuelve a intentarlo más tarde; también puedes cambiar a otro modelo disponible.

Verifica con curllink

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

WorkBuddy 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
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "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 dirección de API en WorkBuddy debe terminar en /v1?
No. Usa https://api.wokey.ai y deja apagado el interruptor de protocolo personalizado. Solo con el protocolo personalizado activado ingresas la dirección completa https://api.wokey.ai/v1/chat/completions; si no coinciden, devuelve 404.
¿Qué va en el nombre del modelo?
El ID exacto del modelo, por ejemplo deepseek-v4.1-flash, sin espacios ni sufijos. Cualquier otra cosa devuelve model_not_found.
¿Por qué fallan las solicitudes con imágenes?
Comprueba que el modelo sea deepseek-v4.1-flash y que el interruptor de entrada de imágenes esté activado. deepseek-v4-flash es un modelo de texto, así que desactiva la entrada de imágenes cuando lo uses.