Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Adicionar fornecedores personalizados

Aula 7 de 16 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Por que utilizar fornecedores de terceiros?
  2. Anatomia de um fornecedor
  3. Exemplos de fornecedores comuns
  4. Declarar um modelo num fornecedor
  5. Exemplo completo: OpenRouter
  6. Fornecedor local com Ollama
  7. Pontos-chave

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 -latest antes 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/completions será 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.

Fornecedorapi_baseapi_key_env_var
OpenRouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
Ollama (local)http://localhost:11434/v1—
Together AIhttps://api.together.xyz/v1TOGETHER_API_KEY
Groqhttps://api.groq.com/openai/v1GROQ_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
  • /model permite alternar entre modelos durante uma sessão
  • Fornecedores locais (Ollama, vLLM) permitem trabalhar offline