Providers Guide: Connect AI Models to OmniRoute (Español)

¿Qué es un proveedor?

Piensa en un proveedor como una compañía telefónica. Del mismo modo que necesitas una compañía telefónica para hacer llamadas, necesitas un proveedor de IA para usar modelos de IA. OmniRoute es como un teléfono que funciona con todas las compañías: puedes cambiar entre ellas automáticamente.

Tipos de proveedores

Tipo	Qué es	Ejemplos	Coste
Gratuito	No requiere pago	Kiro, OpenCode Free, Pollinations	$0
Clave de API	Necesitas una clave de API	OpenAI, Anthropic, Google	Pago por uso
OAuth	Inicias sesión con tu cuenta	Claude Code, GitHub Copilot	Suscripción
Cookie web	Usa la sesión de tu navegador	ChatGPT Web (Codex), Gemini Web	$0 (usa tu cuenta)

Proveedores mediante cookies web

Consulta WEB-COOKIE-GUIDE.md para obtener instrucciones generales de configuración, información sobre limitaciones y resolución de problemas, y orientación de autenticación específica para cada proveedor.

Inicio rápido: conecta tu primer proveedor

Configuración opcional de proveedores gratuitos durante el primer inicio

El asistente del primer inicio ofrece una tarjeta explícita llamada Configurar proveedores gratuitos. Obtiene la lista actual de proveedores aptos del registro de proveedores sin autenticación de OmniRoute y, a continuación, te permite revisar y deseleccionar cada proveedor antes de confirmar. OmniRoute muestra el aviso de precaución del proveedor y un enlace a su sitio para que puedas revisar primero las condiciones, la privacidad, la disponibilidad y los límites de uso de terceros.

Esta acción es opcional: completar el asistente nunca crea conexiones con proveedores gratuitos de forma silenciosa. Solo crea los proveedores que aún faltan, no modifica las conexiones existentes personalizadas e informa individualmente de los proveedores creados, ya configurados y fallidos. Si el resultado es parcial, puedes volver a intentar de forma segura únicamente los que hayan fallado.

Opción A: proveedor gratuito (sin tarjeta de crédito)

1. Abre el panel de control en http://localhost:20128
2. Ve a Proveedores → Añadir proveedor
3. Selecciona uno de estos proveedores gratuitos:
   • Kiro AI — Modelos Claude gratuitos (no requieren autenticación)
   • OpenCode Free — Modelos GPT gratuitos (no requieren autenticación)
   • Pollinations — GPT-5, Claude y Gemini gratuitos (no requieren clave)
   • LongCat — 10 millones de tokens gratuitos (concesión única; requiere cuenta y KYC)
   • Cloudflare AI — Más de 50 modelos, 10 000 neuronas/día
   • MLX Gemma 26B — Modelo local para Apple Silicon (~38,5 tok/s, ~15,9 GB de RAM)
   • MLX Qwen 3.8 27B — Modelo local para Apple Silicon (~9,1 tok/s, ~13,1 GB de RAM)
4. Haz clic en Conectar
5. ¡Listo! Ya tienes acceso gratuito a la IA.

Opción B: proveedor con clave de API (de pago)

1. Obtén una clave de API en el sitio web del proveedor:
   • OpenAI: https://platform.openai.com/api-keys
   • Anthropic: https://console.anthropic.com/
   • Google: https://aistudio.google.com/apikey
   • DeepSeek: https://platform.deepseek.com/
   • Groq: https://console.groq.com/
2. Abre el panel de control en http://localhost:20128
3. Ve a Proveedores → Añadir proveedor
4. Selecciona tu proveedor
5. Pega tu clave de API
6. Haz clic en Conectar
7. ¡Listo! Ya tienes acceso a los modelos de ese proveedor.

Opción C: proveedor OAuth (suscripción)

1. Abre el panel de control en http://localhost:20128
2. Ve a Proveedores → Añadir proveedor
3. Selecciona tu proveedor (p. ej., Claude Code o GitHub Copilot)
4. Haz clic en Conectar con OAuth
5. Inicia sesión con tu cuenta
6. ¡Listo! Ya tienes acceso a los modelos de tu suscripción.

Opción D: modelos MLX locales (Apple Silicon)

Para equipos Mac con Apple Silicon y memoria unificada, OmniRoute permite conectarse a modelos MLX locales que se ejecutan mediante mlx-lm.server como proveedores locales normales compatibles con OpenAI.

Requisitos previos

• Mac con Apple Silicon (M1/M2/M3/M4); se recomiendan al menos 24 GB de memoria unificada
• Gestor de paquetes uv: curl -LsSf https://astral.sh/uv/install.sh | sh
• mlx-lm: uv pip install mlx-lm

Inicio rápido

1. Instala las dependencias:

   # Instala uv si aún no está instalado
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Instala mlx-lm
   uv pip install mlx-lm

2. Inicia manualmente los servidores MLX (en terminales distintas):

   # Terminal 1: Gemma 4 26B A4B IT-QAT (puerto 11435)
   uv run mlx_lm.server --model mlx-community/gemma-4-26B-A4B-it-qat-q4_0-mlx-aligned --port 11435 --host 127.0.0.1
   
   # Terminal 2: Qwen 3.8 27B MLX Mixed (puerto 11436)
   uv run mlx_lm.server --model maglun/Qwen3.8-27B-MLX-Mixed-3.80bpw --port 11436 --host 127.0.0.1

3. Conéctate desde el panel de control de OmniRoute:

   • Ve a Proveedores → Añadir proveedor
   • Selecciona MLX Gemma 26B o MLX Qwen 3.8 27B
   • Haz clic en Conectar (no se necesita una clave de API)

4. Úsalo con OpenCode:

   # Configura OpenCode para usar OmniRoute
   opencode config set api.base_url http://localhost:20128/v1
   opencode config set api.key <your-omniroute-api-key>
   
   # Usa modelos MLX
   opencode run --model mlx-gemma/gemma-4-26b
   opencode run --model mlx-qwen/qwen3.8-27b

Gestión de la memoria

Importante: Con 24 GB de memoria unificada, solo se puede ejecutar un modelo MLX grande a la vez.

• Gemma 26B: ~15,9 GB de memoria máxima
• Qwen 3.8 27B: ~13,1 GB de memoria máxima

Debes gestionar esto manualmente:

• Ejecuta solo un servidor MLX a la vez, o
• Ejecuta ambos en equipos distintos, o
• Detén uno antes de iniciar el otro

OmniRoute no gestiona automáticamente los procesos de los servidores MLX; únicamente dirige las solicitudes a los endpoints compatibles con OpenAI que configures.

Compatibilidad con llamadas a herramientas

Ambos modelos admiten llamadas a herramientas compatibles con OpenAI. Pruébalas con:

curl -X POST http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mlx-gemma/gemma-4-26b",
    "messages": [{"role": "user", "content": "¿Cuánto es 2+2? Usa la herramienta de cálculo."}],
    "tools": [{"type": "function", "function": {"name": "calculator", "description": "Calcular", "parameters": {"type": "object", "properties": {"expression": {"type": "string"}}, "required": ["expression"]}}}]
  }'

Solución de problemas

Problema	Solución
El servidor no se inicia	Consulta uv run mlx_lm.server --help y verifica los identificadores de los modelos
Memoria insuficiente	Asegúrate de que solo se ejecute un modelo; cierra otras aplicaciones; consulta el Monitor de Actividad
Conexión rechazada	Verifica que el servidor se esté ejecutando en el puerto correcto (11435/11436)
Respuestas lentas	La primera solicitud carga el modelo en la memoria (~30-60s); las solicitudes posteriores son rápidas
Fallan las llamadas a herramientas	Asegúrate de que el modelo admita herramientas; revisa los registros de OmniRoute para detectar errores de traducción

---

Mejores proveedores gratuitos

Estos proveedores ofrecen acceso gratuito sin tarjeta de crédito:

Proveedor	Cuota gratuita	Modelos	Cómo conectarse
Kiro AI	50 créditos/mes	Claude Sonnet 4.5, Haiku 4.5, Opus 4.6	No requiere autenticación
OpenCode Free	Ilimitada	GPT-4o, Claude, Gemini	No requiere autenticación
Pollinations	No requiere clave	GPT-5, Claude, Gemini, DeepSeek, Llama 4	No requiere autenticación
LongCat	10M por única vez	LongCat-2.0	Clave de API + KYC
Cloudflare AI	10K neuronas/día	Más de 50 modelos	No requiere autenticación
NVIDIA NIM	~40 RPM	129 modelos	Requiere clave de API
Cerebras	$5 de crédito al registrarse	GLM 4.7, GPT-OSS 120B	Clave de API + tarjeta
Qoder	Ilimitada	Kimi-K2, DeepSeek-R1, Qwen3-coder	No requiere autenticación

Consejo: ¡Conecta varios proveedores gratuitos para obtener IA gratuita ilimitada con conmutación automática en caso de error!

---

Mejores proveedores de pago

Estos proveedores ofrecen modelos de alta calidad con claves de API:

Proveedor	Mejores modelos	Coste	Nivel gratuito
OpenAI	GPT-5, GPT-4o	$2.50-$10/1M tokens	$5 en créditos gratuitos
Anthropic	Claude Opus 4.6, Sonnet 4.6	$3-$15/1M tokens	$5 en créditos gratuitos
Google	Gemini 2.5 Pro, Flash	$0.075-$1.25/1M tokens	1,500 solicitudes/día gratis
DeepSeek	DeepSeek V4	$0.14-$0.28/1M tokens	5M tokens gratuitos
Groq	Llama 4, Mixtral	$0.05-$0.27/1M tokens	30 RPM gratis
xAI	Grok 3	$0.30-$0.60/1M tokens	—

---

Cómo conectar un proveedor (paso a paso)

Paso 1: Abre el panel

Ve a http://localhost:20128 en tu navegador.

Paso 2: Ve a Proveedores

Haz clic en Proveedores en la barra lateral.

Paso 3: Haz clic en Añadir proveedor

Haz clic en el botón + Añadir proveedor.

Paso 4: Selecciona tu proveedor

Explora la lista o busca tu proveedor. Haz clic en él.

Paso 5: Introduce las credenciales

• Proveedores gratuitos: No se necesitan credenciales; solo haz clic en Conectar
• Proveedores con clave de API: Pega tu clave de API
• Proveedores OAuth: Haz clic en Conectar con OAuth e inicia sesión

Paso 6: Prueba la conexión

Haz clic en Probar conexión para verificar que funciona.

Paso 7: ¡Listo!

Tu proveedor ya está conectado. Puedes usarlo con model: "auto" o especificar el proveedor directamente.

---

Uso de varios proveedores

OmniRoute funciona mejor con varios proveedores. Esto te ofrece:

• Conmutación automática en caso de error — Si un proveedor falla, OmniRoute prueba con el siguiente
• Optimización de costes — OmniRoute elige el proveedor más barato para cada solicitud
• Optimización de velocidad — OmniRoute elige el proveedor más rápido para cada solicitud
• Optimización de calidad — OmniRoute elige el mejor proveedor para cada tarea

Configuración recomendada

Conecta al menos 3 proveedores para obtener la mejor experiencia:

1. Un proveedor gratuito (Kiro, OpenCode Free o Pollinations) — Siempre disponible
2. Un proveedor rápido (Groq, Cerebras) — Para obtener respuestas rápidas
3. Un proveedor de alta calidad (OpenAI, Anthropic, Google) — Para tareas complejas

Después, usa model: "auto" y OmniRoute elegirá automáticamente el mejor para cada solicitud.

---

Configuración específica de cada proveedor

OpenAI

1. Obtén una clave de API: https://platform.openai.com/api-keys
2. En OmniRoute: Proveedores → Añadir proveedor → OpenAI
3. Pega la clave de API → Conectar

Anthropic

1. Obtén una clave de API: https://console.anthropic.com/
2. En OmniRoute: Proveedores → Añadir proveedor → Anthropic
3. Pega la clave de API → Conectar

Google (Gemini)

1. Obtén una clave de API: https://aistudio.google.com/apikey
2. En OmniRoute: Proveedores → Añadir proveedor → Gemini
3. Pega la clave de API → Conectar

DeepSeek

1. Obtén una clave de API: https://platform.deepseek.com/
2. En OmniRoute: Proveedores → Añadir proveedor → DeepSeek
3. Pega la clave de API → Conectar

Groq

1. Obtén una clave de API: https://console.groq.com/
2. En OmniRoute: Proveedores → Añadir proveedor → Groq
3. Pega la clave de API → Conectar

---

Preguntas frecuentes

“¿Necesito pagar para usar OmniRoute?”

¡No! OmniRoute es gratuito y de código abierto. Puedes usar proveedores gratuitos (Kiro, OpenCode Free, Pollinations) sin pagar nada. Solo pagas si decides utilizar proveedores de pago.

“¿Con qué proveedor debería empezar?”

Empieza con Kiro AI: es gratuito, no requiere una clave de API y te da acceso a los modelos de Claude. Después, añade más proveedores según sea necesario.

“¿Puedo usar varios proveedores a la vez?”

¡Sí! Ese es precisamente el objetivo de OmniRoute. Conecta varios proveedores y usa model: "auto" para que OmniRoute elija el mejor para cada solicitud.

“¿Qué ocurre si un proveedor deja de funcionar?”

OmniRoute omite automáticamente los proveedores que fallen y prueba con el siguiente. No necesitas hacer nada.

“¿Cómo desconecto un proveedor?”

Ve a Proveedores → haz clic en el proveedor → haz clic en Desconectar.

“¿Puedo usar mis claves de API actuales?”

¡Sí! Si ya tienes claves de API para OpenAI, Anthropic, Google, etc., puedes usarlas en OmniRoute. Solo tienes que pegarlas al conectar el proveedor.

---

¿Qué sigue?

• Guía de Auto-Combo — Deja que OmniRoute elija la mejor IA para ti
• Guía de niveles gratuitos — Obtén IA gratuita sin tarjeta de crédito
• Solución de problemas — Soluciona problemas comunes
• Referencia de proveedores — Lista completa de 226 proveedores

Imágenes de Cursor

Las imágenes del plan Cursor usan IMAGE_PROVIDERS.cursor (cursor-agent-image). Consulta CURSOR_IMAGE.md.

---

Código fuente de OmniRoute (a58000c7685f)