Przejdź do głównej treści
Polski— Wybierz język
Menu

Dodawanie własnych dostawców

Lekcja 7 z 16 Zaktualizowano 2 listopada 2026 Programista
Na tej stronie
  1. Dlaczego korzystać z zewnętrznych dostawców?
  2. Budowa dostawcy
  3. Przykłady popularnych dostawców
  4. Deklarowanie modelu u dostawcy
  5. Pełny przykład: OpenRouter
  6. Lokalny dostawca z Ollama
  7. Kluczowe wnioski

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/completions zostanie 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.

Dostawcaapi_baseapi_key_env_var
OpenRouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
Ollama (lokalny)http://localhost:11434/v1—
Together AIhttps://api.together.xyz/v1TOGETHER_API_KEY
Groqhttps://api.groq.com/openai/v1GROQ_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
  • /model pozwala przełączać się między modelami podczas sesji
  • Dostawcy lokalni (Ollama, vLLM) umożliwiają pracę offline