Προσθήκη προσαρμοσμένων παρόχων
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 2 Νοεμβρίου 2026 — Devstral. Το Devstral 2 (
devstral-2512) έφτασε στο τέλος του κύκλου ζωής του στις 31 Ιουλίου 2026 και το Devstral Small 2 στις 31 Μαρτίου 2026: οι κλήσεις σε αυτά τα μοντέλα δεν είναι πλέον εγγυημένες. Ο επίσημος πίνακας τα ανακατευθύνει στο Mistral Medium 3.5, το οποίο έχει επίσης καταργηθεί υπέρ του Mistral Large 4. Το Codestral (codestral-2508) παραμένει γενικά διαθέσιμο για συμπλήρωση κώδικα. Ελέγξτε τον πίνακα μοντέλων για να δείτε πού οδηγούν τα ψευδώνυμα-latestπριν επαναχρησιμοποιήσετε αυτά τα παραδείγματα.
Γιατί να χρησιμοποιήσετε παρόχους τρίτων;
Εξ ορισμού, το Vibe επικοινωνεί με το API της Mistral. Ωστόσο, η αρχιτεκτονική του εργαλείου έχει σχεδιαστεί για να είναι ανεξάρτητη από τον πάροχο: μπορείτε να προσθέσετε οποιονδήποτε πάροχο συμβατό με τη μορφή του OpenAI API. Αυτό καλύπτει τέσσερις πραγματικές ανάγκες. Μπορείτε να αποκτήσετε πρόσβαση σε μοντέλα άλλων προμηθευτών—Claude, GPT, Llama—να δρομολογήσετε αιτήματα μέσω ενός αναμεταδότη όπως το OpenRouter για να συγκρίνετε πολλαπλά μοντέλα στην ίδια εργασία, να συνδεθείτε με μια τοπική εγκατάσταση (Ollama, vLLM) όταν ο κώδικας δεν πρέπει να εξέρχεται από το μηχάνημα, ή να αλλάζετε παρόχους ανάλογα με τη φύση της εργασίας.
Ένα τυπικό σενάριο αφορά μια ομάδα που εργάζεται καθημερινά με το Devstral 2 μέσω του Mistral API, αλλά μεταβαίνει σε μια τοπική εγκατάσταση κάθε φορά που χειρίζεται ένα αποθετήριο πελάτη που υπόκειται σε περιορισμούς εμπιστευτικότητας.
Δομή ενός παρόχου
Δηλώνετε έναν πάροχο στο αρχείο config.toml χρησιμοποιώντας την οδηγία [[providers]]:
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
Κάθε πεδίο έχει συγκεκριμένο ρόλο:
- name — Μοναδικό αναγνωριστικό για τον πάροχο (χρησιμοποιείται για την αναφορά στα μοντέλα)
- api_base — Βασική URL του API (το endpoint
/chat/completionsθα προσαρτηθεί αυτόματα) - api_key_env_var — Όνομα της μεταβλητής περιβάλλοντος που περιέχει το κλειδί API
- api_style — Μορφή API. Χρησιμοποιήστε
"openai"για οποιονδήποτε πάροχο συμβατό με το OpenAI - backend — Τύπος backend. Το
"generic"λειτουργεί στις περισσότερες περιπτώσεις
Η κλασική παγίδα αφορά το api_base: καθώς το Vibe προσαρτά μόνο του το /chat/completions, μια URL που περιλαμβάνει ήδη αυτό το επίθημα θα οδηγήσει σε μη έγκυρη διεύθυνση και σε ένα σφάλμα δικτύου δύσκολο στη διάγνωση.
Παραδείγματα κοινών παρόχων
Ακολουθούν οι τιμές που πρέπει να εισαγάγετε για τις πιο διαδεδομένες υπηρεσίες. Οι δύο τοπικοί πάροχοι δεν έχουν μεταβλητή κλειδιού, καθώς δεν απαιτούν πιστοποίηση.
| Πάροχος | api_base | api_key_env_var |
|---|---|---|
| OpenRouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
| Ollama (τοπικό) | 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 | — |
Δήλωση ενός μοντέλου σε έναν πάροχο
Η δήλωση του παρόχου δεν αρκεί: πρέπει στη συνέχεια να συνδέσετε τα μοντέλα που σκοπεύετε να χρησιμοποιήσετε.
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"
temperature = 0.2
Το πεδίο name επαναλαμβάνει το αναγνωριστικό του μοντέλου ακριβώς όπως το γνωρίζει ο πάροχος, χαρακτήρα προς χαρακτήρα. Το provider πρέπει να ταιριάζει με το name ενός παρόχου που δηλώθηκε προηγουμένως, διαφορετικά το Vibe δεν θα γνωρίζει πού να στείλει το αίτημα. Το alias ορίζει μια συντομευμένη ονομασία για χρήση εντός του Vibe, και το temperature ορίζει τη δημιουργικότητα, από 0.0 για ντετερμινιστική συμπεριφορά έως 1.0 για ένα πιο εφευρετικό μοντέλο. Για κώδικα, μια χαμηλή τιμή όπως αυτή του παραδείγματος αποδίδει πολύ πιο σταθερά αποτελέσματα.
Για να ενεργοποιήσετε αυτό το μοντέλο ως προεπιλογή, απλώς επαναχρησιμοποιήστε το ψευδώνυμό του:
active_model = "devstral-openrouter"
Πλήρες παράδειγμα: OpenRouter
Ακολουθεί μια πλήρης διαμόρφωση με έναν πάροχο και δύο συνδεδεμένα μοντέλα:
# ~/.vibe/config.toml
# Πάροχος OpenRouter
[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"
# Δωρεάν μοντέλο Devstral μέσω OpenRouter
[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-free"
temperature = 0.2
# Μοντέλο Llama μέσω OpenRouter
[[models]]
name = "meta-llama/llama-3.3-70b-instruct"
provider = "openrouter"
alias = "llama-70b"
temperature = 0.3
Η διαμόρφωση από μόνη της δεν αρκεί: πρέπει ακόμα να ορίσετε τη μεταβλητή περιβάλλοντος που αναμένει ο πάροχος, διαφορετικά οι κλήσεις θα πραγματοποιηθούν χωρίς πιστοποίηση.
export OPENROUTER_API_KEY="sk-or-votre-cle-ici"
Μόλις δηλωθούν και τα δύο μοντέλα, διαθέτετε δύο εναλλάξιμα ψευδώνυμα. Κατά τη διάρκεια μιας συνεδρίας, η εντολή /model devstral-free εναλλάσσεται μεταξύ τους χωρίς να χάνεται η συνομιλία, επιτρέποντάς σας να συγκρίνετε δύο απαντήσεις στο ίδιο πρόβλημα. Κατά την εκκίνηση, η επιλογή --model κάνει το ίδιο πράγμα: vibe --model llama-70b.
Τοπικός πάροχος με Ollama
Η περίπτωση ενός μοντέλου που εξυπηρετείται τοπικά αξίζει ένα ξεχωριστό παράδειγμα, καθώς δεν απαιτεί κλειδί API: το πεδίο api_key_env_var απλώς παραμένει κενό.
[[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"
Το πλεονέκτημα είναι άμεσο: τα δεδομένα σας δεν εγκαταλείπουν ποτέ το μηχάνημά σας. Αυτή είναι η επιλογή που πρέπει να κάνετε για εργασία σε ευαίσθητο κώδικα, ή απλώς για να συνεχίσετε την κωδικοποίηση σε ένα τρένο χωρίς σύνδεση στο διαδίκτυο.
Βασικά σημεία
- Το Vibe υποστηρίζει οποιονδήποτε πάροχο συμβατό με τη μορφή του OpenAI API
- Δηλώστε έναν πάροχο με
[[providers]]στο config.toml - Κάθε μοντέλο συνδέεται με έναν πάροχο και μπορεί να έχει ένα ψευδώνυμο
- Η εντολή
/modelσας επιτρέπει να εναλλάσσεστε μεταξύ μοντέλων κατά τη διάρκεια μιας συνεδρίας - Οι τοπικοί πάροχοι (Ollama, vLLM) επιτρέπουν την εργασία εκτός σύνδεσης