Inicio / Guías / Use OpenCode con una API de LLM gratuita

Use OpenCode con una API de LLM gratuita

OpenCode es un agente de programación de código abierto para la terminal y el escritorio. Acepta cualquier proveedor compatible con OpenAI. Esta guía conecta OpenCode con modelos gratuitos a través de FreeLLMAPI. Un comando escribe la configuración y guarda la clave.

El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.

Paso 1: Instale FreeLLMAPI

FreeLLMAPI es una pasarela de código abierto. Se ejecuta en su computadora con Docker y reúne los niveles gratuitos de 45 proveedores detrás de una sola clave.

Instale en macOS o Linux

curl -fsSL https://freellmapi.co/install.sh | bash

Abra http://localhost:3001. Añada al menos dos claves de proveedores gratuitos en la página Keys. Google AI Studio y Groq dan cada uno una clave gratuita en pocos minutos. Copie su clave unificada de la misma página.

Paso 2: Conecte OpenCode con un comando

Un comando

npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencode

El comando hace tres cosas:

  • Añade un proveedor freellmapi a ~/.config/opencode/opencode.json. El proveedor enumera los modelos de su catálogo actual con sus límites de contexto.
  • Define freellmapi/auto como modelo predeterminado.
  • Guarda la clave en el archivo de credenciales de OpenCode, ~/.local/share/opencode/auth.json. No necesita una variable de entorno, ni en la CLI ni en la aplicación de escritorio.

El comando hace una copia de seguridad antes de escribir. Combina el proveedor nuevo, así que sus otros proveedores se mantienen. Si XDG_CONFIG_HOME o XDG_DATA_HOME están definidas, el comando usa esas carpetas.

Antes de iniciar una tarea larga, compruebe que la pasarela puede atender una solicitud ahora. Esta llamada enumera solo los modelos que tienen una clave utilizable en este momento:

Compruebe qué modelos están listos

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

Un modelo con el estado exhausted tiene claves, pero todas están en su límite en este momento. Este estado se borra cuando terminan los periodos de enfriamiento. Ejecute npx freellmapi doctor para asegurarse de que las solicitudes de un cliente llegan a la pasarela. El registro de solicitudes del panel muestra cada llamada desde OpenCode. El encabezado de respuesta X-Routed-Via indica el proveedor y el modelo que respondieron a cada solicitud. Si una solicitud cambió de proveedor, el encabezado X-Fallback-Trail indica cada salto fallido y el motivo.

Configuración manual: el bloque de proveedor en opencode.json

Para configurarlo manualmente, añada este bloque a ~/.config/opencode/opencode.json, o a opencode.json de su proyecto. OpenCode usa @ai-sdk/openai-compatible para los endpoints /v1/chat/completions.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "freellmapi/auto",
  "provider": {
    "freellmapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "FreeLLMAPI",
      "options": {
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

Después añada la clave. Inicie OpenCode, ejecute /connect, seleccione el proveedor freellmapi y pegue su clave unificada. El ID del proveedor en /connect debe coincidir con el ID de la configuración. Ejecute /models para seleccionar un modelo.

  • limit.context es el número máximo de tokens de entrada del modelo. limit.output es el número máximo de tokens que puede generar.
  • El model de nivel superior usa el formato provider/model. Sin él, OpenCode mantiene el modelo que usaba antes.
  • Cada ID de modelo que quiera usar debe estar en el mapa models. Añada más IDs desde GET /v1/models.
Nota sobre las versiones de configuración: la documentación de OpenCode describe ahora un formato de configuración V2 con una clave providers. La documentación indica que el formato V1 anterior sigue siendo compatible. El comando de configuración de FreeLLMAPI escribe el formato V1.

Elija modelos para OpenCode

OpenCode es un agente. Lee archivos, los edita y ejecuta comandos mediante llamadas a herramientas. Cada solicitud lleva un prompt de sistema, definiciones de herramientas y contenido de archivos. Use modelos con llamadas a herramientas y una ventana de contexto amplia.

Modelos gratuitos para OpenCode: llamadas a herramientas y más de 128K de contexto
ModeloGratis enContextoLímites gratuitos (mejor oferta)HerramientasVisión
GLM 5.3UnoRouter1M1 solicitudes/min
1 req/min per model
SíNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 solicitudes/min
40 RPM
SíSí
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSíSí
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSíNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSíSí
Gemini 3.7 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSíSí
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 solicitudes/min
50 solicitudes/día
50 req/day account-wide (1,000 after a $10 purchase)
SíSí
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 solicitudes/min
50 solicitudes/día
Shared rate limit
SíNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 solicitudes/min
250 solicitudes/día
70,000 tokens/min
~6M
SíSí
Gemini 3.6 FlashGoogle AI Studio1M10 solicitudes/min
20 solicitudes/día
250,000 tokens/min
~3M
SíSí
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/daySíSí

Se muestran 12 de 109 modelos gratuitos que coinciden. Ver todos los modelos.

Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.

Use freellmapi/auto para que el enrutador seleccione un modelo para cada solicitud. Añada auto:smart o auto:fast al mapa models para dirigir las solicitudes por inteligencia o por velocidad. También puede añadir un perfil con nombre, por ejemplo auto:coding, después de crearlo en el panel.

Límites de uso y sesiones largas

Una tarea de agente puede enviar decenas de solicitudes. Un solo nivel gratuito agota una tarea larga con rapidez. FreeLLMAPI cuenta las solicitudes y los tokens de cada clave. Cuando un proveedor envía un error 429, el enrutador envía la solicitud al siguiente modelo de la cadena, y la sesión continúa.

  • Añada claves de cuatro o más proveedores. Más proveedores dan más solicitudes por día.
  • Active el traspaso de contexto con FREELLMAPI_CONTEXT_HANDOFF=on_model_switch en el .env de FreeLLMAPI. Cuando cambia el modelo, el modelo siguiente recibe una nota breve que indica que continúa una tarea.
  • Las sesiones fijas mantienen una conversación en un mismo modelo durante 30 minutos. Así el agente se mantiene coherente.
  • Inicie una sesión nueva para cada tarea. Un contexto más pequeño usa menos tokens por solicitud.

Solución de problemas

ProblemaCausaSolución
"Invalid API key" con una clave válidaUn apiKey vacío en la configuración reemplaza la clave de /connectElimine apiKey de options, o ejecute setup-opencode otra vez
OpenCode no usa el proveedor nuevoEl model de nivel superior no está definidoDefina "model": "freellmapi/auto"
Modelo no encontradoEl ID del modelo no está en el mapa models del proveedorAñada el ID al mapa, o ejecute setup-opencode otra vez
La clave {env:VAR} está vacíaOpenCode reemplaza una variable sin definir por una cadena vacíaExporte la variable en la misma shell, o guarde la clave con /connect
Fallan las llamadas a herramientasEl modelo tiene llamadas a herramientas débilesSeleccione un modelo de la tabla anterior
« Todos los modelos con límite de uso después de N intentos »Todas las claves han alcanzado su límiteAñada claves de más proveedores, o espere a que terminen los periodos de enfriamiento
Use cada uno de estos modelos con una sola clave. FreeLLMAPI es un enrutador de código abierto y autoalojado. Reúne todos estos niveles gratuitos detrás de un único endpoint compatible con OpenAI y cambia de proveedor cuando uno alcanza su límite. Explore el catálogo o ir en vivo.

Preguntas frecuentes

¿Puedo usar OpenCode gratis?

Sí. OpenCode es de código abierto. Conéctelo a FreeLLMAPI como proveedor compatible con OpenAI. La pasarela envía cada solicitud a niveles gratuitos de proveedores, así que la inferencia cuesta $0.

¿Cómo añado un proveedor personalizado compatible con OpenAI a OpenCode?

Añada un proveedor en opencode.json con npm definido como @ai-sdk/openai-compatible, options.baseURL y un mapa models. Después ejecute /connect para guardar la clave y /models para seleccionar un modelo.

¿Qué modelo gratuito es el mejor para OpenCode?

Use un modelo con llamadas a herramientas y al menos 128K de contexto. La tabla de esta página muestra los modelos gratuitos más sólidos que cumplen hoy ambas reglas. Use freellmapi/auto para que el enrutador seleccione uno.

¿Dónde guarda OpenCode las claves de API?

Las claves añadidas con /connect van a ~/.local/share/opencode/auth.json. El comando de configuración de FreeLLMAPI escribe la clave allí, así que tanto la CLI como la aplicación de escritorio la encuentran.

Guías relacionadas

Fuentes

Todas las guías · Ver todos los modelos gratuitos