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

Use Aider con una API de LLM gratuita

Aider es un programador en pareja de código abierto para la terminal. Edita archivos en su repositorio de git y crea commits. Esta guía conecta Aider con modelos gratuitos mediante FreeLLMAPI. También muestra los ajustes de Aider que son importantes para los modelos gratuitos: formato de edición, modelo débil y tamaño del mapa del repositorio.

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. Reúne los niveles gratuitos de 45 proveedores detrás de una sola clave compatible con OpenAI.

Instalar en macOS o Linux

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

Abra http://localhost:3001. Agregue al menos dos claves gratuitas de proveedores en la página Keys. Copie su clave unificada desde la misma página.

Paso 2: Conecte Aider

El comando de configuración escribe ~/.aider.conf.yml. Antes crea una copia de seguridad del archivo existente.

Un solo comando

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

El archivo que escribe el comando se ve así:

~/.aider.conf.yml

openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"

El prefijo openai/ es obligatorio. Indica a Aider que envíe el nombre del modelo a una API compatible con OpenAI. Para usar variables de entorno y no un archivo, haga esto:

Solo variables de entorno

export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/auto

Aider busca .aider.conf.yml en su directorio personal, luego en la raíz de su repositorio de git y después en el directorio actual. El archivo que se carga al final tiene prioridad. Por eso, un archivo de proyecto puede cambiar el modelo de un solo repositorio.

Paso 3: Elija los modelos

Aider envía sus archivos y un mapa del repositorio en cada solicitud. No necesita llamadas a herramientas para su bucle principal de edición, porque lee las ediciones del texto del modelo. Son más importantes una ventana de contexto amplia y un buen seguimiento de instrucciones. La tabla muestra los modelos gratuitos con al menos 128K de contexto hoy.

Modelos gratuitos para Aider: 128K+ de contexto, por inteligencia
ModeloGratis enContextoLímites gratuitos (mejor oferta)HerramientasVisión
GLM 5.3APINex, UnoRouter1M5 solicitudes/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
SíNo
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 más1M40 solicitudes/min
40 RPM
SíSí
Gemini 3.8 FlashAPINex, Google AI Studio1M5 solicitudes/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
SíSí
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceSíNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSíSí
Deepseek V4.1 FlashAPINex1M5 solicitudes/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NoNo
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
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary resetNoNo
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 más262K30 solicitudes/min
250 solicitudes/día
70,000 tokens/min
~6M
SíSí

Se muestran 12 de 184 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 openai/auto para que el enrutador elija un modelo. Use openai/auto:smart para preferir los modelos con mayor inteligencia. Para fijar un modelo, use openai/ y un ID del catálogo de GET /v1/models.

También puede configurar los modelos de una sesión en la línea de comandos. Este ejemplo usa los modelos más sólidos para las ediciones. Usa modelos rápidos para los mensajes de commit y los resúmenes del historial del chat:

Modelos para una sesión

aider --model openai/auto:smart --weak-model openai/auto:fast

Para un perfil planificado, cree una cadena de respaldo en el panel de FreeLLMAPI, por ejemplo una cadena llamada coding. Después, use --model openai/auto:coding. Un nombre de perfil desconocido devuelve un error 400, así que la solicitud no pasa a otra cadena sin aviso.

Ajustes de Aider para modelos gratuitos

Aider conoce los ajustes de los modelos más conocidos. Un modelo de pasarela como auto no es conocido, así que configure estos valores usted mismo.

AjusteQué haceValor recomendado para modelos gratuitos
edit-formatEl formato que usa el modelo para enviar ediciones: whole, diff, diff-fenced o udiffdiff para modelos sólidos. whole para modelos débiles, porque es más simple, pero envía más tokens.
weak-modelEl modelo para los mensajes de commit y los resúmenes del historial del chatopenai/auto:fast, para que las tareas pequeñas no usen la cuota de su modelo sólido
map-tokensEl número de tokens para el mapa del repositorio. 0 lo desactiva.1024 o menos en niveles gratuitos pequeños
architectUn modelo planifica el cambio y un modelo editor escribe las edicionesOpcional. Duplica el número de solicitudes.

~/.aider.conf.yml con ajustes para modelos gratuitos

openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024

Para dar a Aider la ventana de contexto de un modelo de pasarela, agregue un archivo .aider.model.metadata.json. La clave es el nombre completo del modelo. Aider busca este archivo en los mismos lugares que el archivo de configuración.

~/.aider.model.metadata.json

{
  "openai/auto": {
    "max_input_tokens": 128000,
    "max_output_tokens": 8192,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Límites de uso y conmutación

Los niveles gratuitos tienen límites por minuto y por día. FreeLLMAPI cuenta el uso de cada clave. Cuando un proveedor envía un error 429, el enrutador envía la solicitud al siguiente modelo de su cadena. Aider no ve el error y continúa.

  • Agregue claves de cuatro o más proveedores. Más proveedores dan más solicitudes por día.
  • Agregue solo los archivos que quiere cambiar con /add. Cada archivo está en cada solicitud.
  • Use /clear entre tareas para enviar un historial de chat más corto. Un historial corto también reduce los tokens por minuto.
  • Use /drop para quitar los archivos que ya no necesita.

Solución de problemas

ProblemaCausaSolución
"Modelo openai/auto: tamaño de ventana de contexto y costos desconocidos, se usan valores predeterminados razonables."Aider no conoce el modelo de la pasarelaEsta advertencia suele ser inofensiva. Para quitarla, agregue .aider.model.metadata.json.
La edición no se aplicóEl modelo no siguió el formato de ediciónUse --edit-format whole, o un modelo más sólido
401 "Invalid API key"Aider envía una clave distinta, por ejemplo desde otro archivo de configuraciónRevise los archivos de configuración del directorio personal, de la raíz de git y del directorio actual
Aider llama a api.openai.comSe usa el prefijo openai/, pero no se configuró la base URLConfigure openai-api-base o OPENAI_API_BASE
"Todos los modelos alcanzaron su límite tras N intentos"Todas las claves llegaron a su límiteAgregue claves de más proveedores, o reduzca map-tokens
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 Aider gratis?

Sí. Aider es de código abierto. Apúntelo a FreeLLMAPI con openai-api-base y el prefijo de modelo openai/. La pasarela usa niveles gratuitos de proveedores, así que la inferencia cuesta $0.

¿Cómo uso Aider con una API compatible con OpenAI?

Configure OPENAI_API_BASE y OPENAI_API_KEY, y luego ejecute aider --model openai/. El prefijo openai/ es obligatorio. Puede poner los mismos valores en .aider.conf.yml.

¿Qué formato de edición debo usar con modelos gratuitos?

Use diff para modelos sólidos, porque envía menos tokens. Si las ediciones no se aplican, use whole. Es más simple para modelos débiles, pero envía el archivo completo cada vez.

¿Qué significa 'Unknown context window size and costs, using sane defaults'?

Aider no conoce el nombre del modelo, así que usa valores predeterminados. La advertencia suele ser inofensiva. Agregue .aider.model.metadata.json con la ventana de contexto para quitarla.

¿Cuál es el mejor modelo gratuito para Aider?

Use un modelo con una ventana de contexto amplia y un buen seguimiento de instrucciones. La tabla de esta página muestra los modelos gratuitos más sólidos con 128K o más de contexto hoy.

Guías relacionadas

Fuentes

Todas las guías · Ver todos los modelos gratuitos