Adicionar fornecedores personalizados
Nesta página
Atualizado a 2 de novembro de 2026 — Devstral. O Devstral 2 (
devstral-2512) chegou ao fim da sua vida útil a 31 de julho de 2026, e o Devstral Small 2 a 31 de março de 2026: as chamadas a estes modelos já não estão garantidas. A tabela oficial redireciona-os para o Mistral Medium 3.5, que está, por sua vez, preterido em favor do Mistral Large 4. O Codestral (codestral-2508) mantém-se geralmente disponível para conclusão de código. Consulte a tabela de modelos para verificar para onde apontam os aliases-latestantes de reutilizar estes exemplos.
Por que utilizar fornecedores de terceiros?
Por predefinição, o Vibe comunica com a API da Mistral. No entanto, a arquitetura da ferramenta foi concebida para ser agnóstica: pode adicionar qualquer fornecedor compatível com o formato da API OpenAI. Isto responde a quatro necessidades reais. Pode aceder a modelos de outros fornecedores — Claude, GPT, Llama —, encaminhar através de um relé como o OpenRouter para comparar vários modelos na mesma tarefa, apontar para uma instância local (Ollama, vLLM) quando o código não pode sair da máquina ou alternar entre fornecedores consoante a natureza do trabalho.
Um cenário típico envolve uma equipa que trabalha diariamente com o Devstral 2 na API da Mistral, mas muda para uma instância local sempre que lida com um repositório de cliente sujeito a restrições de confidencialidade.
Anatomia de um fornecedor
Declara um fornecedor no ficheiro config.toml utilizando a diretiva [[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 tem um papel específico:
- name — Identificador único do fornecedor (utilizado para referenciar modelos)
- api_base — URL base da API (o endpoint
/chat/completionsserá adicionado automaticamente) - api_key_env_var — Nome da variável de ambiente que contém a chave da API
- api_style — Formato da API. Utilize
"openai"para qualquer fornecedor compatível com OpenAI - backend — Tipo de backend.
"generic"funciona na maioria dos casos
A armadilha clássica reside no api_base: como o Vibe adiciona /chat/completions por si só, um URL que já inclua este sufixo resultará num endereço inválido e num erro de rede difícil de diagnosticar.
Exemplos de fornecedores comuns
Eis os valores a introduzir para os serviços mais difundidos. Os dois fornecedores locais não possuem variável de chave, pois não requerem autenticação.
| Fornecedor | 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 um modelo num fornecedor
Declarar o fornecedor não é suficiente: deve depois associar os modelos que pretende utilizar.
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2
O campo name repete o identificador do modelo exatamente como o fornecedor o conhece, caractere por caractere. O campo provider deve corresponder ao name de um fornecedor declarado anteriormente; caso contrário, o Vibe não saberá para onde enviar o pedido. O campo alias define um nome abreviado a utilizar no Vibe, e temperature define a criatividade, de 0,0 para um comportamento determinístico a 1,0 para um modelo mais inventivo. Para código, um valor baixo como o do exemplo produz resultados muito mais estáveis.
Para ativar este modelo por predefinição, basta reutilizar o seu alias:
active_model = "devstral-openrouter"
Exemplo completo: OpenRouter
Eis uma configuração completa com um fornecedor e dois modelos associados:
# ~/.vibe/config.toml
# Fornecedor 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 via OpenRouter
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2
# Modelo Llama via OpenRouter
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3
A configuração por si só não basta: ainda precisa de definir a variável de ambiente que o fornecedor espera, caso contrário as chamadas serão efetuadas sem autenticação.
export OPENROUTER_API_KEY="sk-or-votre-cle-ici"
Uma vez declarados ambos os modelos, dispõe de dois aliases intercambiáveis. Durante uma sessão, /model devstral-free alterna entre eles sem perder a conversa, permitindo-lhe comparar duas respostas para o mesmo problema. No arranque, a opção --model faz o mesmo: vibe --model llama-70b.
Fornecedor local com Ollama
O caso de um modelo servido localmente merece um exemplo separado, pois não requer chave de API: o campo api_key_env_var permanece simplesmente vazio.
[[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"
A vantagem é direta: os seus dados nunca saem da sua máquina. Esta é a opção a escolher para trabalhar em código sensível ou, simplesmente, para continuar a programar num comboio sem ligação à Internet.
Pontos-chave
- O Vibe suporta qualquer fornecedor compatível com o formato da API OpenAI
- Declare um fornecedor com
[[providers]]no config.toml - Cada modelo é associado a um fornecedor e pode ter um alias
/modelpermite alternar entre modelos durante uma sessão- Fornecedores locais (Ollama, vLLM) permitem trabalhar offline