Conecta DeepSeek Harness a CheapTokens: proveedor personalizado

Para usar DeepSeek Harness con CheapTokens, abre Settings → Models, cambia la tarjeta a Custom model API, establece la URL base en https://api.cheaptokens.dev/v1, elige OpenAI Chat Completions como protocolo, pega tu clave de CheapTokens y añade el id del modelo deepseek-ai/DeepSeek-V4-Flash-0731. Selecciona ese modelo en el selector y tu siguiente sesión se ejecutará con él.

Ese es todo el truco. El resto de esta página es el formulario exacto, una comprobación rápida de que la clave funciona antes de culpar a la aplicación, y una breve lista de qué revisar cuando la pasarela dice que no.

Los ajustes siguientes provienen de la documentación de Harness a fecha del 24 de octubre de 2026. El proyecto está en vista previa pública, y su README advierte de que habrá cambios que rompan la compatibilidad, así que si una etiqueta se ha movido, confía en la pantalla y en la guía del proveedor.

Qué estás conectando#

DeepSeek Harness es un agente de código abierto de DeepSeek (licencia MIT, construido sobre la arquitectura de plugins Cordis). Viene como aplicación de escritorio para macOS en Apple silicon y Windows de 64 bits, o como interfaz web que inicias con npx @deepseek-ai/dsh web (requiere Node.js). La interfaz web se abre en http://127.0.0.1:3080 por defecto.

De fábrica pide una clave de DeepSeek. Pero la misma pantalla de Models tiene una tarjeta para cualquier cosa que no esté en su catálogo, un relay, una pasarela corporativa u otro proveedor. Esa tarjeta es la que usamos.

Del lado de CheapTokens necesitas dos cosas: una clave y un saldo. Si aún no has creado una clave, Tu primera petición a la API con CheapTokens tarda un par de minutos, y Qué es una clave de API y cómo guardarla de forma segura cubre dónde guardarla.

Comprueba la clave antes de abrir Harness#

Una petición desde el terminal te dice si la clave, el saldo y el id del modelo están bien. Si esto funciona y Harness no, el problema está en el formulario, no en la cuenta.

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hi in five words."}]
  }'

Deberías obtener una respuesta JSON con un array choices y un bloque usage que cuenta los tokens de entrada y salida. Un error de estilo Invalid API key significa que es la clave; un mensaje sobre el saldo significa que toca recargar.

Rellena el formulario de proveedor personalizado#

Abre Settings → Models y cambia la tarjeta del proveedor a Custom model API. Rellena los campos así:

Dos detalles hacen tropezar a la gente. Primero, la URL base es https://api.cheaptokens.dev/v1, exactamente como en el curl de arriba menos /chat/completions. Segundo, el id del modelo es el completo con el prefijo deepseek-ai/. Un nombre corto como deepseek-v4-flash no es lo que espera la API. Si quieres los antecedentes sobre base_url y cómo cambiarla, consulta API compatible con OpenAI: qué es base_url y cómo cambiarla.

También hay un botón Fetch available models. La documentación dice que consulta GET /models y que siempre puedes escribir el id a mano. Escribirlo es la vía segura aquí, así que hazlo.

Elige el modelo y ejecuta una primera tarea#

Abre el selector de modelos y elige el modelo de CheapTokens. Elegir un modelo ahí lo convierte en el predeterminado para nuevas sesiones, así que no tienes que repetirlo.

Ahora dale algo pequeño y comprobable. Supongamos que tienes un proyecto con un test que falla:

Run the tests, find why test_parse_date fails and fix it. Show me the diff.

Lo que quieres ver: el agente ejecuta el comando de test, lee el archivo que falla, lo edita, vuelve a ejecutar los tests y muestra un diff. Si hace eso, la conexión está lista. Tu saldo es ahora lo que paga el bucle.

Por qué un modelo barato encaja en un bucle de agente#

Un agente no envía una sola pregunta. Envía toda la conversación, los listados de archivos y la salida de las herramientas de nuevo en cada paso, así que una sesión es en su mayoría tokens de entrada. Eso es lo que hace sorprendentes las facturas de los agentes (por qué un chat largo cuesta más explica la mecánica, y Cómo estimar el coste de un agente de IA da el método).

Supongamos que una sesión tiene 200 pasos, cada paso envía unos 30.000 tokens de contexto y recibe unos 600 tokens de vuelta. Eso son 200 × 30.000 = 6.000.000 tokens de entrada y 200 × 600 = 120.000 tokens de salida. Con DeepSeek-V4-Flash esa sesión cuesta $0.102 a los precios de hoy, y es más barata que OpenRouter en total, contando entrada y salida juntas. La tabla siguiente usa la misma carga de trabajo para cada modelo que ofrecemos:

Para sesiones largas, DeepSeek-V4-Flash te da una ventana de contexto de 380K, hasta 32.768 tokens en una respuesta, y un único precio a cualquier hora: sin recargo en horas punta. Usa el mismo saldo que todos los demás modelos de CheapTokens, así que puedes cambiar de modelo en Harness sin recargar de nuevo. Las tarifas actuales están en la página de precios, y la página del modelo tiene más sobre la línea DeepSeek.

¿Prefieres mantener la sesión más ligera? Añade zai-org/GLM-5.3-Flash (390K de contexto, hasta 8.192 tokens de salida) o MiniMaxAI/MiniMax-M2.7 (180K de contexto, hasta 8.192 tokens de salida) al mismo proveedor como ids de modelo adicionales. Un proveedor puede alojar varios modelos, y el selector te permite moverte entre ellos.

Si no funciona#

La documentación de Harness enumera los sospechosos habituales. Aquí están con qué hacer:

• La pasarela rechaza todas las peticiones aunque la clave y la URL sean correctas. La forma de la petición difiere de lo que espera el endpoint. Harness tiene ajustes de compatibilidad por modelo, como el rol usado para el prompt de sistema o el nombre del campo de tokens de salida. Viven en $DSH_HOME/profiles/<profile>/cordis.patch.yml y se recargan sin reiniciar. Toma las claves exactas de la guía del proveedor en lugar de adivinarlas.
• Falta el menú de esfuerzo para el modelo que escribiste. Harness muestra niveles de razonamiento solo para modelos que los declaran. Un modelo introducido a mano no tiene ninguno declarado, así que el menú queda vacío. Declarar niveles forma parte del mismo archivo de ajustes por modelo.
• 401 al obtener modelos. Comprueba la clave, o sáltate el botón e introduce el id del modelo tú mismo.
• Una respuesta se corta a mitad de frase. Eso es un límite de tokens, no una conexión rota; consulta por qué una respuesta de IA se corta a mitad de frase.
• Un 401 o 403 en el log desde la primera petición. Repite la comprobación con curl de arriba con la misma clave. Si curl funciona, vuelve a escribir la clave en el campo Credential; un espacio de más al final es un clásico.

Si ya usas otro agente con la misma clave, conectar OpenCode sigue el mismo patrón, y la documentación de CheapTokens enumera todos los endpoints. Una herramienta más en el mismo cajón, un solo saldo.

Antes de cerrar la pestaña#

• URL base: https://api.cheaptokens.dev/v1
• Protocolo: OpenAI Chat Completions
• Id del modelo: deepseek-ai/DeepSeek-V4-Flash-0731
• Clave: de tu cuenta de CheapTokens, fuera de capturas de pantalla y repositorios

Ejecuta la tarea del test que falla una vez y observa el uso en tu saldo. Esa única ejecución te dice cuánto cuestan tus propias sesiones.