Το σημείο πρόσβασης /v1/chat/completions
Σε αυτήν τη σελίδα
Ενημέρωση 2 Νοεμβρίου 2026 — Μοντέλα. Τα Mistral Large 3 (
mistral-large-2512) και Mistral Medium 3.5 καταργήθηκαν στις 31 Οκτωβρίου 2026 και θα αποσυρθούν οριστικά στις 30 Απριλίου 2027. Ο διάδοχός τους, το Mistral Large 4 (mistral-large-4), βρίσκεται σε δημόσια προεπισκόπηση από τις 6 Οκτωβρίου. Τα παραδείγματα αυτού του μαθήματος χρησιμοποιούν το ψευδώνυμοmistral-large-latest, το οποίο αυτή τη στιγμή δείχνει στο Mistral Large 3 σύμφωνα με την επίσημη προδιαγραφή (επαληθεύτηκε στις 3 Νοεμβρίου 2026). Ομοίως, τοmistral-medium-latestδείχνει στο Mistral Medium 3.5. Αυτά τα ψευδώνυμα θα παραμείνουν έγκυρα έως τις 30 Απριλίου 2027. Για νέα έργα, δοκιμάστε τοmistral-large-4, τον ορισμένο διάδοχό τους.
Η Πύλη σας προς τα Μοντέλα Mistral
Ό,τι κάνετε με το API της Mistral περνάει από ένα μοναδικό μονοπάτι: το /v1/chat/completions. Αυτό είναι το κεντρικό σημείο της πλατφόρμας, το οποίο διαχειρίζεται όλες τις συνομιλιακές σας αλληλεπιδράσεις με τα γλωσσικά μοντέλα. Είτε χτίζετε ένα εσωτερικό chatbot υποστήριξης, έναν εξαγωγέα που μετατρέπει τιμολόγια PDF σε γραμμές βάσης δεδομένων, είτε έναν βοηθό συγγραφής ενσωματωμένο στο CMS σας, αυτές οι τρεις φαινομενικά διαφορετικές εφαρμογές καλούν το ακριβώς ίδιο σημείο πρόσβασης, απλώς με διαφορετικά μηνύματα και παραμέτρους. Δεν χρειάζεται να μάθετε τρεις ξεχωριστές ενσωματώσεις· αρκεί να κατακτήσετε μία.
Από τον Απρίλιο του 2026, αυτό το σημείο πρόσβασης διαχειρίζεται δισεκατομμύρια αιτήματα καθημερινά παγκοσμίως. Η κατανόηση της δομής του είναι το πρώτο βήμα για την αξιοποίηση των μοντέλων Mistral σε περιβάλλον παραγωγής.
Η Βασική Διεύθυνση (Base URL)
Όλα τα αιτήματα προς το API της Mistral ξεκινούν από την ίδια βάση:
https://api.mistral.ai/v1/chat/completions
Στέλνετε ένα αίτημα POST με σώμα JSON που περιέχει τα μηνύματα και τις παραμέτρους σας, και το API επιστρέφει μια δομημένη απόκριση JSON. Δεν υπάρχουν συνεδρίες προς άνοιγμα ούτε κατάσταση διακομιστή (server-side state) προς διατήρηση: κάθε κλήση είναι αυτόνομη.
Ανατομία ενός Αιτήματος
Ο γρηγορότερος τρόπος για να επαληθεύσετε ότι το κλειδί σας λειτουργεί είναι να στείλετε ένα ελάχιστο αίτημα χρησιμοποιώντας curl απευθείας από το τερματικό σας:
curl https://api.mistral.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MISTRAL_API_KEY" \
-d '{
"model": "mistral-large-latest",
"messages": [
{"role": "user", "content": "Hello, how does your API work?"}
]
}'
Δύο κεφαλίδες είναι υποχρεωτικές: η Content-Type: application/json περιγράφει τη μορφή του σώματος του αιτήματος και η Authorization: Bearer <your-key> μεταφέρει την ταυτοποίησή σας. Το ίδιο το σώμα πρέπει να περιέχει τουλάχιστον δύο πεδία: το model, τον αναγνωριστικό κωδικό του μοντέλου προς χρήση, και το messages, τον πίνακα που μεταφέρει τη συνομιλία.
Ισοδύναμο σε Python με το SDK
Μόλις ξεπεράσετε τη φάση των δοκιμών, κανείς δεν γράφει ωμές εντολές curl σε περιβάλλον παραγωγής. Το επίσημο SDK πραγματοποιεί την ίδια κλήση σε λίγες μόνο γραμμές:
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": "Hello, how does your API work?"}
]
)
print(response.choices[0].message.content)
Το SDK διαχειρίζεται για εσάς τις κεφαλίδες, τη σειριοποίηση JSON και την ανάλυση της απόκρισης. Διαχειρίζεται επίσης αυτόματες επαναλήψεις για προσωρινά σφάλματα, γλιτώνοντάς σας από τη συγγραφή της δικής σας λογικής επανάληψης όταν μια αιχμή κίνησης προκαλεί παροδική αποτυχία.
Δομή της Απόκρισης
Ανεξάρτητα από το πώς καλείτε το API, αυτό επιστρέφει πάντα το ίδιο αντικείμενο JSON:
{
"id": "cmpl-abc123",
"object": "chat.completion",
"created": 1712150400,
"model": "mistral-large-latest",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! The Mistral API works..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 15,
"completion_tokens": 87,
"total_tokens": 102
}
}
Τρία πεδία αξίζουν την άμεση προσοχή σας. Το choices είναι ένας πίνακας που περιέχει την/τις παραγόμενη/ες απόκριση/εις· εδώ θα βρείτε το κείμενο για εμφάνιση στον χρήστη. Το usage παρέχει τον αριθμό των tokens για την είσοδο, την έξοδο και το σύνολο, επιτρέποντάς σας να παρακολουθείτε το πραγματικό κόστος κάθε λειτουργίας αντί να ανακαλύπτετε τον λογαριασμό στο τέλος του μήνα. Τέλος, το finish_reason εξηγεί γιατί σταμάτησε το μοντέλο: stop για φυσικό τέλος, length όταν το όριο tokens διέκοψε την απόκριση, ή tool_calls όταν το μοντέλο ζητά εκτέλεση εργαλείου. Μια περίληψη που τελειώνει στη μέση της πρότασης σχεδόν ποτέ δεν είναι πρόβλημα του μοντέλου· είναι ένα finish_reason τύπου length που κανείς δεν διάβασε.
Συχνοί Κωδικοί Σφάλματος
Όταν κάτι πάει στραβά, το API επιστρέφει τυπικούς κωδικούς HTTP:
- 400 — Εσφαλμένο αίτημα (μη έγκυρο JSON, λείπουσα παράμετρος)
- 401 — Μη έγκυρο ή λείπον κλειδί API
- 429 – Έχει επιτευχθεί το όριο ρυθμού (πάρα πολλά αιτήματα)
- 500 — Σφάλμα διακομιστή (δοκιμάστε ξανά μετά από λίγα δευτερόλεπτα)
Στην Python, το SDK εγείρει typed exceptions (εξαιρέσεις με τύπο) που μπορείτε να πιάσετε, επιτρέποντάς σας να διακρίνετε μεταξύ ενός ληγμένου κλειδιού και προσωρινού κορεσμού, αντιδρώντας διαφορετικά σε κάθε περίπτωση:
from mistralai.client import Mistral
from mistralai.client.errors import SDKError
client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))
try:
response = client.chat.complete(
model="mistral-large-latest",
messages=[{"role": "user", "content": "Test"}]
)
except SDKError as e:
print(f"API Error: {e.status_code} — {e.message}")
Κάντε συνήθεια να τυλίγετε κάθε κλήση σε αυτό το μπλοκ από το πολύ πρώτο σας script. Την ημέρα που η εφαρμογή σας θα τρέχει χωρίς επιτήρηση, θα σας πει τι απέτυχε αντί να σταματήσει σιωπηλά.
Βασικά σημεία
- Το σημείο πρόσβασης
/v1/chat/completionsείναι το μοναδικό απαραίτητο για συνομιλιακές αλληλεπιδράσεις - Κάθε αίτημα απαιτεί ένα
modelκαι έναν πίνακαmessages - Η απόκριση περιέχει πάντα τα
choices,usageκαιfinish_reason - Το Python SDK απλοποιεί σημαντικά τις κλήσεις σε σύγκριση με το
curl - Τα tokens χρήσης σάς επιτρέπουν να υπολογίζετε με ακρίβεια το κόστος σας