Dodawanie własnych dostawców
Na tej stronie
Zaktualizowano 2 listopada 2026 — Devstral. Devstral 2 (
devstral-2512) osiągnął koniec wsparcia 31 lipca 2026 r., a Devstral Small 2 – 31 marca 2026 r.: wywołania tych modeli nie są już gwarantowane. Oficjalna tabela przekierowuje je do Mistral Medium 3.5, który z kolei jest przestarzały na rzecz Mistral Large 4. Codestral (codestral-2508) pozostaje ogólnodostępny do uzupełniania kodu. Sprawdź tabelę modeli, aby zobaczyć, gdzie wskazują aliasy-latest, przed ponownym użyciem tych przykładów.
Dlaczego korzystać z zewnętrznych dostawców?
Domyślnie Vibe komunikuje się z API Mistral. Jednak architektura narzędzia została zaprojektowana jako agnostyczna: możesz dodać dowolnego dostawcę kompatybilnego z formatem API OpenAI. Rozwiązuje to cztery rzeczywiste potrzeby. Możesz uzyskać dostęp do modeli od innych producentów – Claude, GPT, Llama – kierować ruch przez przekaźnik taki jak OpenRouter, aby porównać wiele modeli w tym samym zadaniu, wskazać instancję lokalną (Ollama, vLLM), gdy kod nie może opuścić maszyny, lub zmieniać dostawców w zależności od charakteru pracy.
Typowym scenariuszem jest zespół, który na co dzień pracuje z Devstral 2 przez API Mistral, ale przełącza się na instancję lokalną za każdym razem, gdy obsługuje repozytorium klienta objęte klauzulą poufności.
Budowa dostawcy
Dostawcę deklarujesz w pliku config.toml, używając dyrektywy [[providers]]:
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
Każde pole pełni określoną rolę:
- name – Unikalny identyfikator dostawcy (używany do odwoływania się do modeli)
- api_base – Bazowy URL API (ścieżka
/chat/completionszostanie automatycznie dopisana) - api_key_env_var – Nazwa zmiennej środowiskowej zawierającej klucz API
- api_style – Format API. Użyj
"openai"dla dowolnego dostawcy kompatybilnego z OpenAI - backend – Typ backendu.
"generic"działa w większości przypadków
Klasycznym błędem jest pole api_base: ponieważ Vibe sam dopisuje /chat/completions, URL zawierający już ten sufiks spowoduje powstanie nieprawidłowego adresu i trudnego do zdiagnozowania błędu sieciowego.
Przykłady popularnych dostawców
Oto wartości, które należy wprowadzić dla najbardziej rozpowszechnionych usług. Dwa lokalne dostawcy nie mają zmiennej klucza, ponieważ nie wymagają uwierzytelniania.
| Dostawca | api_base | api_key_env_var |
|---|---|---|
| OpenRouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
| Ollama (lokalny) | 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 (self-hosted) | http://votre-serveur:8000/v1 | — |
Deklarowanie modelu u dostawcy
Sama deklaracja dostawcy nie wystarczy: musisz następnie dołączyć modele, z których zamierzasz korzystać.
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2
Pole name powtarza identyfikator modelu dokładnie tak, jak zna go dostawca, znak po znaku. provider musi odpowiadać polu name dostawcy zadeklarowanego wcześniej, w przeciwnym razie Vibe nie będzie wiedział, gdzie wysłać żądanie. alias definiuje skrótową nazwę używaną wewnątrz Vibe, a temperature ustawia poziom kreatywności, od 0.0 dla zachowania deterministycznego do 1.0 dla modelu bardziej inventywnego. W przypadku kodu niska wartość, taka jak w przykładzie, daje znacznie stabilniejsze wyniki.
Aby domyślnie włączyć ten model, wystarczy ponownie użyć jego aliasu:
active_model = "devstral-openrouter"
Pełny przykład: OpenRouter
Oto kompletna konfiguracja z jednym dostawcą i dwoma dołączonymi modelami:
# ~/.vibe/config.toml
# Dostawca OpenRouter
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
# Darmowy model Devstral przez OpenRouter
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2
# Model Llama przez OpenRouter
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3
Sama konfiguracja nie wystarczy: musisz nadal zdefiniować zmienną środowiskową, której oczekuje dostawca, w przeciwnym razie wywołania zostaną wysłane bez uwierzytelnienia.
export OPENROUTER_API_KEY="sk-or-votre-cle-ici"
Gdy oba modele są zadeklarowane, masz do dyspozycji dwa wymienne aliasy. Podczas sesji polecenie /model devstral-free przełącza między nimi bez utraty konwersacji, co pozwala porównać dwie odpowiedzi dotyczące tego samego problemu. Przy uruchamianiu opcja --model robi to samo: vibe --model llama-70b.
Lokalny dostawca z Ollama
Przypadek modelu obsługiwanego lokalnie zasługuje na osobny przykład, ponieważ nie wymaga klucza API: pole api_key_env_var po prostu pozostaje puste.
[[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"
Zaleta jest bezpośrednia: Twoje dane nigdy nie opuszczają Twojej maszyny. Jest to opcja do wyboru przy pracy nad wrażliwym kodem lub po prostu, aby kontynuować programowanie w pociągu bez połączenia z internetem.
Kluczowe wnioski
- Vibe obsługuje dowolnego dostawcę kompatybilnego z formatem API OpenAI
- Zadeklaruj dostawcę za pomocą
[[providers]]w pliku config.toml - Każdy model jest dołączony do dostawcy i może mieć alias
/modelpozwala przełączać się między modelami podczas sesji- Dostawcy lokalni (Ollama, vLLM) umożliwiają pracę offline