Cómo conectar OpenCode a CheapTokens (opencode.json)

Para conectar OpenCode a CheapTokens, añade un proveedor personalizado compatible con OpenAI: guarda tu clave de API con /connect (ID de proveedor cheaptokens), luego describe el proveedor en opencode.json con la URL base https://api.cheaptokens.dev/v1. Después de eso, tus modelos de CheapTokens aparecen en /models.

Esta guía sigue la documentación de proveedores de OpenCode (página actualizada el 20 de octubre de 2026; verificada el 22 de octubre de 2026). El mismo enfoque funciona para las otras herramientas de esta serie: Cline, Aider y Kilo Code.

Lo que necesitas#

• OpenCode instalado (consulta su documentación para tu plataforma).
• Una clave de API de CheapTokens. Crea una en tu cuenta y recarga el saldo; un saldo cubre todos los modelos. Lo básico está en la documentación de CheapTokens.
• Los datos de la API:
  • URL base: https://api.cheaptokens.dev/v1
  • compatibilidad: OpenAI Chat Completions y Anthropic Messages
  • ID de modelo usado abajo: deepseek-ai/DeepSeek-V4-Flash-0731 (contexto de 380K, hasta 32.768 tokens de salida). Los ID de modelo se listan en la documentación de CheapTokens: los nombres difieren entre proveedores, así que copia el ID de allí.

Paso 1. Guarda la clave con /connect#

1. Inicia OpenCode en tu proyecto y ejecuta /connect.
2. Desplázate hasta Other.
3. Introduce un ID de proveedor único: cheaptokens.
4. Pega tu clave de API de CheapTokens.

Este paso solo guarda la credencial. OpenCode todavía no conoce la dirección ni los modelos del proveedor: para eso está opencode.json.

Paso 2. Describe el proveedor en opencode.json#

Crea o edita opencode.json y añade el proveedor. El ID de proveedor en provider debe coincidir con el que introdujiste en /connect.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

Qué hace cada parte:

• npm — @ai-sdk/openai-compatible es el paquete para endpoints que usan /v1/chat/completions, que es lo que expone CheapTokens. (OpenCode usa @ai-sdk/openai para endpoints construidos sobre /v1/responses.)
• name — la etiqueta que se muestra en la interfaz de OpenCode.
• options.baseURL — la dirección de la API de CheapTokens.
• models — indexado por ID de modelo; el name dentro es un nombre para mostrar.
• limit.context / limit.output — opcionales; le indican a OpenCode la ventana de contexto del modelo y la longitud máxima de respuesta.

Mejor guarda la clave en una variable de entorno (opcional)#

Si prefieres no guardar la clave en el almacén de credenciales de OpenCode, añade apiKey a options con la sintaxis {env:VARIABLE} que recomienda la documentación:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

Luego exporta CHEAPTOKENS_API_KEY en tu shell. No hagas commit de una clave real al repositorio. Si eres nuevo con las claves, lee qué es una clave de API y cómo guardarla de forma segura.

Paso 3. Comprueba que funciona#

Ejecuta /models y elige DeepSeek-V4-Flash bajo el proveedor CheapTokens. Luego envía un prompt corto, por ejemplo: "Resume en tres frases qué hace este repositorio." Una respuesta normal significa que la URL base, la clave y el ID de modelo son correctos.

Qué modelo de CheapTokens elegir#

Añade tantas entradas a models como quieras — cada una es un bloque como el de arriba, con su propio ID.

Para una sesión de OpenCode, que envía muchas solicitudes en bucle, DeepSeek-V4-Flash es un buen valor por defecto: la salida es más barata que el precio de referencia de OpenRouter, las respuestas pueden alcanzar los 32.768 tokens y el precio no tiene horas pico. MiniMax-M2.7 también es más barato que los precios de referencia de OpenRouter tanto en entrada como en salida. La salida de GLM-5.3-Flash también es más barata que el precio de referencia de OpenRouter. Precios actuales (verificados en vivo, sin números que queden obsoletos):

Para estimar una sesión de trabajo, por ejemplo 20 solicitudes con 100.000 tokens de entrada y 5.000 de salida cada una:

Consulta todos los precios y la página de DeepSeek para más información.

Si no funciona#

• Falta el proveedor o los modelos en /models. Comprueba que opencode.json sea JSON válido (sin comas finales) y que la clave bajo provider sea exactamente el ID que introdujiste en /connect. Si ambos son correctos, reinicia OpenCode.
• 401 / error de autenticación. Vuelve a ejecutar /connect y pega la clave de nuevo, o comprueba la variable CHEAPTOKENS_API_KEY en el shell donde se inicia OpenCode.
• 404 o "model not found". El ID de modelo en models debe coincidir con el ID de CheapTokens carácter por carácter, incluido el prefijo del proveedor (deepseek-ai/…).
• Errores de conexión. La URL base debe terminar en /v1 y no contener ninguna ruta adicional. Consulta errores de conexión comunes.
• "Not enough tokens". Recarga el saldo; consulta qué significa el error.

Próximos pasos#

Ahora tienes OpenCode funcionando sobre CheapTokens con un solo saldo para todos los modelos. Consigue una clave y haz tu primera llamada desde la documentación de CheapTokens.