Usa la API de Wokey con DeepSeek Harness

1. 1

   Instala la versión preliminar 0.2.1

   La etiqueta latest de npm sigue siendo 0.2.0; DeepSeek recomienda v0.2.1-rc.1 o posterior para V4.1-Flash-1017, así que instala @next.

2. 2

   Define la variable de la clave de API

   La configuración solo nombra apiKeyEnv, así que la clave nunca queda en el archivo. También puedes guardar la clave en Settings → Models en la interfaz web.

3. 3

   Agrega el provider

   Edita ~/.dsh/profiles/web/cordis.patch.yml (profiles/headless para dsh headless). Este ejemplo usa Anthropic Messages para ambos modelos, con https://api.wokey.ai como base URL. Si eliges OpenAI Chat Completions, crea un provider aparte y usa https://api.wokey.ai/v1.

4. 4

   Declara la entrada de imagen

   DeepSeek Harness trata un modelo personalizado no declarado como solo texto, así que puede rechazar una imagen antes de que Wokey vea la solicitud, aunque el modelo de Wokey admita visión. Para Opus 5.5, Haiku 5.5 o cualquier otro modelo con visión, agrega input: [text, image] bajo ese modelo; en la interfaz, usa Settings → Models → editar el provider → Customized settings → expandir la fila del modelo → Input types → Image. Guarda y luego inicia una sesión nueva.

5. 5

   Conserva los providers existentes

   Esta sobrescritura reemplaza toda la config de la entrada llm-pi-ai, así que si ya agregaste providers en la interfaz, inclúyelos también bajo providers. Usa espacios en cada sangría y no mezcles tabulaciones en el YAML. Inicia una sesión nueva después de guardar.

# 1. Instalar o actualizar a 0.2.1
npm install -g @deepseek-ai/dsh@next
export WOKEY_API_KEY="YOUR_API_KEY"

# 2. ~/.dsh/profiles/web/cordis.patch.yml
- id: llm-pi-ai
  config:
    providers:
      wokey:
        displayName: Wokey
        apiKeyEnv: WOKEY_API_KEY
        api: anthropic-messages
        baseURL: https://api.wokey.ai
        models:
          - id: claude-opus-5-5
            name: Claude Opus 5.5
            contextWindow: 1000000
            input: [text, image]
          - id: deepseek-v4.1-flash
            name: DeepSeek-V4.1-Flash
            contextWindow: 1000000
            maxTokens: 393216
            input: [text, image]
- id: agent-default-model
  config:
    provider: wokey
    model: claude-opus-5-5

# 3. Iniciar
dsh web

Dónde se configura: ~/.dsh/profiles/web/cordis.patch.yml

Wokey ofrece las interfaces de inferencia del modelo indicadas en esta página, no los endpoints independientes /v1/tools/search ni /v1/tools/fetch. Admitir llamadas a herramientas no implica admitir cada herramienta web integrada del upstream. La búsqueda del lado del servidor dentro de las solicitudes al modelo depende de la ruta de suministro real y actualmente no figura como una capacidad de Wokey verificada y admitida de forma uniforme; esta página no publica un precio de Wokey por llamada a Search/Fetch. Para búsqueda y fetch independientes con soporte documentado, usa una clave de API de DeepSeek con api.deepseek.com, configurada y cobrada por separado de las llamadas a modelos de Wokey.

• “The current model does not support images”: es la verificación local de capacidades de Harness; no significa que Wokey u Opus 5.5 no tengan visión. Activa Image para ese modelo o agrega input: [text, image] a su entrada en el YAML.
• Las imágenes siguen rechazándose después de guardar: inicia una sesión nueva y vuelve a elegir el modelo; una sesión existente conserva la capacidad del modelo y los adjuntos que registró.
• La solicitud con imagen devuelve 400: haz coincidir el protocolo y la base URL. Anthropic Messages usa https://api.wokey.ai sin /v1; OpenAI Chat Completions usa https://api.wokey.ai/v1. deepseek-v4.1-flash admite ambos formatos, pero el cliente debe enviar la estructura del protocolo elegido.
• La app no inicia o informa un número de línea del YAML: comprueba que input esté anidado bajo el modelo correcto, que todos los guiones de modelo estén alineados y que el archivo no tenga tabulaciones. Restaura una copia de seguridad y vuelve a guardarla solo con espacios.
• La app inicia con “Select a model”: comprueba que agent-default-model siga apuntando a un provider y un modelo que existan. Actualízalo después de eliminar o renombrar un provider.
• El modelo aparece tras el descubrimiento pero sin capacidad de imagen: Fetch available models rellena principalmente los ID y los campos de capacidad. Declara explícitamente input: [text, image] para cada modelo personalizado con visión en lugar de marcar todos los modelos como compatibles con visión.
• Otros providers desaparecieron después de guardar: una sobrescritura en cordis.patch.yml reemplaza toda la entrada llm-pi-ai, así que conserva todos los providers existentes bajo providers.

DeepSeek Harness 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": "deepseek-v4.1-flash",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

¿El baseURL de DeepSeek Harness debe terminar en /v1?

Depende del campo api del provider. Con anthropic-messages usa https://api.wokey.ai sin /v1; OpenAI Chat Completions necesita un provider aparte con https://api.wokey.ai/v1.

¿Por qué dice que el modelo actual no admite imágenes?

Es una comprobación local de capacidades en el Harness: los modelos personalizados declaran solo entrada de texto de forma predeterminada. Agrega input: [text, image] a la entrada del modelo, guarda y vuelve a intentarlo en una sesión nueva.

¿Por qué desaparecieron mis otros providers al guardar?

La sobrescritura llm-pi-ai en cordis.patch.yml reemplaza toda la entrada. Escribe los providers que ya tenías en providers junto con Wokey.