Añadir proveedores personalizados
En esta página
Actualizado el 2 de noviembre de 2026 — Devstral. Devstral 2 (
devstral-2512) llegó al final de su vida útil el 31 de julio de 2026, y Devstral Small 2 el 31 de marzo de 2026: las llamadas a estos modelos ya no están garantizadas. La tabla oficial los redirige a Mistral Medium 3.5, que a su vez está obsoleto en favor de Mistral Large 4. Codestral (codestral-2508) sigue estando disponible generalmente para la finalización de código. Consulta la tabla de modelos para ver a dónde apuntan los alias-latestantes de reutilizar estos ejemplos.
¿Por qué usar proveedores de terceros?
Por defecto, Vibe se comunica con la API de Mistral. Sin embargo, la arquitectura de la herramienta está diseñada para ser agnóstica: puedes añadir cualquier proveedor compatible con el formato de la API de OpenAI. Esto responde a cuatro necesidades reales. Puedes acceder a modelos de otros proveedores (Claude, GPT, Llama), enrutar las peticiones a través de un relé como OpenRouter para comparar múltiples modelos en la misma tarea, apuntar a una instancia local (Ollama, vLLM) cuando el código no debe salir de la máquina, o cambiar de proveedor según la naturaleza del trabajo.
Un escenario típico implica un equipo que trabaja a diario con Devstral 2 en la API de Mistral, pero cambia a una instancia local siempre que maneja un repositorio de cliente sujeto a restricciones de confidencialidad.
Anatomía de un proveedor
Declaras un proveedor en config.toml usando la directiva [[providers]]:
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
Cada campo tiene un rol específico:
- name — Identificador único del proveedor (se usa para referenciar modelos)
- api_base — URL base de la API (el extremo
/chat/completionsse añadirá automáticamente) - api_key_env_var — Nombre de la variable de entorno que contiene la clave de API
- api_style — Formato de la API. Usa
"openai"para cualquier proveedor compatible con OpenAI - backend — Tipo de backend.
"generic"funciona en la mayoría de los casos
La trampa clásica reside en api_base: dado que Vibe añade /chat/completions por su cuenta, una URL que ya incluya este sufijo resultará en una dirección inválida y provocará un error de red difícil de diagnosticar.
Ejemplos de proveedores comunes
Estos son los valores que debes introducir para los servicios más extendidos. Los dos proveedores locales no tienen variable de clave, ya que no requieren autenticación.
| Proveedor | api_base | api_key_env_var |
|---|---|---|
| OpenRouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
| Ollama (local) | http://localhost:11434/v1 | — |
| Together AI | https://api.together.xyz/v1 | TOGETHER_API_KEY |
| Groq | https://api.groq.com/openai/v1 | GROQ_API_KEY |
| vLLM (autoalojado) | http://votre-serveur:8000/v1 | — |
Declarar un modelo en un proveedor
Declarar el proveedor no es suficiente: luego debes adjuntar los modelos que pretendes usar.
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2
El campo name repite el identificador del modelo exactamente como lo conoce el proveedor, carácter por carácter. provider debe coincidir con el name de un proveedor declarado anteriormente; de lo contrario, Vibe no sabrá a dónde enviar la petición. alias define un nombre abreviado para usar dentro de Vibe, y temperature establece la creatividad, desde 0,0 para un comportamiento determinista hasta 1,0 para un modelo más inventivo. Para código, un valor bajo como el del ejemplo produce resultados mucho más estables.
Para habilitar este modelo por defecto, simplemente reutiliza su alias:
active_model = "devstral-openrouter"
Ejemplo completo: OpenRouter
Aquí tienes una configuración completa con un proveedor y dos modelos adjuntos:
# ~/.vibe/config.toml
# Proveedor OpenRouter
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
# Modelo Devstral gratuito vía OpenRouter
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2
# Modelo Llama vía OpenRouter
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3
La configuración por sí sola no basta: aún necesitas definir la variable de entorno que espera el proveedor, o las llamadas saldrán sin autenticación.
export OPENROUTER_API_KEY="sk-or-votre-cle-ici"
Una vez declarados ambos modelos, dispones de dos alias intercambiables. Durante una sesión, /model devstral-free alterna entre ellos sin perder la conversación, lo que te permite comparar dos respuestas sobre el mismo problema. En el lanzamiento, la opción --model hace lo mismo: vibe --model llama-70b.
Proveedor local con Ollama
El caso de un modelo servido localmente merece un ejemplo aparte, ya que no requiere clave de API: el campo api_key_env_var simplemente permanece vacío.
[[providers]]
name = "ollama"
api_base = "http://localhost:11434/v1"
api_key_env_var = ""
api_style = "openai"
backend = "generic"
[[models]]
name = "codestral:latest"
provider = "ollama"
alias = "codestral-local"
La ventaja es directa: tus datos nunca salen de tu máquina. Esta es la opción a elegir para trabajar con código sensible, o simplemente para seguir programando en un tren sin conexión a internet.
Puntos clave
- Vibe admite cualquier proveedor compatible con el formato de la API de OpenAI
- Declara un proveedor con
[[providers]]en config.toml - Cada modelo se adjunta a un proveedor y puede tener un alias
/modelte permite cambiar entre modelos durante una sesión- Los proveedores locales (Ollama, vLLM) permiten trabajar sin conexión