Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Συμβάσεις Ονοματοδοσίας

Μάθημα 13 / 14 Ενημερώθηκε 3 Νοεμβρίου 2026 Αρχάριος
Σε αυτήν τη σελίδα
  1. Κατανόηση των αναγνωριστικών μοντέλων
  2. Οι τρεις μορφές αναγνωριστικών
  3. Τρέχοντα πλήρη αναγνωριστικά
  4. Κύκλος ζωής μοντέλου
  5. Συμβουλές ανά περιβάλλον
  6. Μετάβαση μεταξύ εκδόσεων
  7. Σημεία πρόσβασης API (Endpoints)
  8. Βασικά σημεία

Ενημερώθηκε στις 3 Νοεμβρίου 2026. Με βάση τη σελίδα Models της xAI (ενότητα Model Aliases): ο πίνακας περιλαμβάνει το grok-4.7, το μοντέλο που προτείνει η xAI, και το grok-4.6. Η σύσταση για περιβάλλοντα παραγωγής ακολουθεί την καθοδήγηση της xAI, η οποία συμβουλεύει τη χρήση του ψευδωνύμου (alias) για τις περισσότερες περιπτώσεις χρήσης και της έκδοσης με ημερομηνία για ροές εργασίας που απαιτούν αυστηρή συνέπεια. Πηγή: Models.

Κατανόηση των αναγνωριστικών μοντέλων

Όταν καλείτε το API της xAI, το πεδίο model καθορίζει ποιο μοντέλο θα επεξεργαστεί το αίτημά σας. Η xAI χρησιμοποιεί ένα δομημένο σύστημα ονοματοδοσίας με ψευδώνυμα (aliases) και καρφιτσωμένες εκδόσεις (pinned versions). Η κατανόηση αυτού του συστήματος είναι απαραίτητη για τη διαχείριση της σταθερότητας και της μετάβασης των εφαρμογών σας.

Οι τρεις μορφές αναγνωριστικών

Η xAI προσφέρει τρεις τρόπους αναφοράς σε ένα μοντέλο, ο καθένας με διαφορετική συμπεριφορά:

Απλό ψευδώνυμο (Simple alias)

{
  "model": "grok-4.20"
}

Το απλό ψευδώνυμο δείχνει στην τελευταία σταθερή έκδοση του μοντέλου. Όταν η xAI κυκλοφορεί μια μικρή ενημέρωση, το ψευδώνυμο ανακατευθύνει αυτόματα στη νέα έκδοση. Η εφαρμογή σας χρησιμοποιεί πάντα την πιο πρόσφατη σταθερή έκδοση χωρίς αλλαγές στον κώδικα.

Πλεονέκτημα: επωφελείστε αυτόματα από τις βελτιώσεις. Κίνδυνος: η συμπεριφορά μπορεί να αλλάξει ελαφρώς από τη μία έκδοση στην άλλη.

Ψευδώνυμο latest

{
  "model": "grok-4.20-latest"
}

Το ψευδώνυμο latest δείχνει στην έκδοση αιχμής (bleeding edge)—την απόλυτα τελευταία επανάληψη, συμπεριλαμβανομένων εκδόσεων που δεν έχουν ακόμη προαχθεί σε σταθερές. Αυτή είναι η πιο πρόσφατη αλλά ενδεχομένως η λιγότερο δοκιμασμένη έκδοση.

Πλεονέκτημα: άμεση πρόσβαση στις τελευταίες βελτιώσεις. Κίνδυνος: η συμπεριφορά μπορεί να αλλάξει ανά πάσα στιγμή· είναι πιθανές υποχωρήσεις (regressions).

Καρφιτσωμένη έκδοση (Pinned version)

{
  "model": "grok-4.20-0309"
}

Η καρφιτσωμένη έκδοση αναγνωρίζει μια συγκεκριμένη έκδοση μοντέλου, ευρετηριασμένη με την ημερομηνία κυκλοφορίας της (εδώ, 9 Μαρτίου). Αυτή η έκδοση δεν αλλάζει ποτέ: η συμπεριφορά που παρατηρείτε σήμερα θα είναι ίδια και σε έξι μήνες.

Πλεονέκτημα: απόλυτη σταθερότητα, αναπαράγωγα αποτελέσματα. Κίνδυνος: η έκδοση θα αποσυρθεί τελικά και στη συνέχεια θα αφαιρεθεί.

Τρέχοντα πλήρη αναγνωριστικά

Αναγνωριστικό API Τύπος Συμπεριφορά
grok-4.20-0309-reasoning Καρφιτσωμένη έκδοση Δεν αλλάζει ποτέ
grok-4.20-0309-non-reasoning Καρφιτσωμένη έκδοση Δεν αλλάζει ποτέ
grok-4.20-multi-agent-0309 Καρφιτσωμένη έκδοση Δεν αλλάζει ποτέ
grok-4.7 Ψευδώνυμο Τελευταία σταθερή έκδοση του μοντέλου που προτείνεται από την xAI
grok-4.6 Ψευδώνυμο Τελευταία σταθερή έκδοση
grok-4.5 Ψευδώνυμο Τελευταία σταθερή έκδοση (ψευδώνυμο `grok-4.5-latest` για την απόλυτα τελευταία)
grok-4.3 Ψευδώνυμο Τελευταία σταθερή έκδοση
grok-build-0.1 Ψευδώνυμο Μοντέλο κώδικα, τελευταία σταθερή έκδοση

Κύκλος ζωής μοντέλου

Κάθε μοντέλο της xAI ακολουθεί έναν κύκλο ζωής τριών φάσεων:

  1. Ενεργό (Active) — το μοντέλο είναι διαθέσιμο και συνιστάται για χρήση σε παραγωγή
  2. Υπό απόσυρση (Deprecated) — το μοντέλο λειτουργεί ακόμα, αλλά η xAI συνιστά τη μετάβαση σε νεότερη έκδοση. Ανακοινώνεται μια προθεσμία πριν από την αφαίρεση
  3. Πεπαλαιωμένο (Obsolete) — το μοντέλο αφαιρείται. Τα αιτήματα προς αυτό το μοντέλο αποτυγχάνουν

Παρακολουθείτε τις ανακοινώσεις απόσυρσης στην κονσόλα της xAI και στις σημειώσεις κυκλοφορίας (release notes). Όταν ένα μοντέλο τίθεται υπό απόσυρση, σχεδιάστε τη μετάβασή σας χωρίς να περιμένετε την ημερομηνία αφαίρεσης.

Συμβουλές ανά περιβάλλον

Ανάπτυξη

Χρησιμοποιήστε απλά ψευδώνυμα (grok-4.7, grok-4.3) για να επωφελείστε αυτόματα από τις βελτιώσεις. Στην ανάπτυξη, μια μικρή αλλαγή στη συμπεριφορά μεταξύ εκδόσεων είναι αποδεκτή και σας επιτρέπει να εντοπίσετε ασυμβατότητες πριν την παραγωγή.

Staging και δοκιμές

Χρησιμοποιήστε καρφιτσωμένες εκδόσεις (grok-4.20-0309-reasoning) για να διασφαλίσετε την αναπαραγωγιμότητα των δοκιμών. Αν μια δοκιμή περάσει σήμερα, πρέπει να περάσει και αύριο με ακριβώς το ίδιο αποτέλεσμα.

Παραγωγή

Η xAI συνιστά το απλό ψευδώνυμο ή το ψευδώνυμο -latest για τις περισσότερες περιπτώσεις χρήσης, επιτρέποντάς σας να επωφελείστε αυτόματα από νέες λειτουργίες, και κρατά την έκδοση με ημερομηνία για ροές εργασίας που απαιτούν αυστηρή συνέπεια. Αν η παραγωγή σας εμπίπτει σε αυτή την κατηγορία—ελέγξιμα αποτελέσματα, συμμόρφωση, δοκιμές παλινδρόμησης—καρφιτσώστε την έκδοση με ημερομηνία και σχεδιάστε περιοδικές μεταβάσεις μετά από επικύρωση στο staging.

Μετάβαση μεταξύ εκδόσεων

Όταν μεταβαίνετε από μία έκδοση σε άλλη:

  1. Ενημερώστε το πεδίο model στα αιτήματά σας
  2. Δοκιμάστε τα υπάρχοντα prompts σας—τα νεότερα μοντέλα ενδέχεται να απαντούν διαφορετικά
  3. Ελέγξτε τις παραμέτρους API—μια νέα έκδοση μπορεί να υποστηρίζει ή να αποσύρει ορισμένες παραμέτρους
  4. Επικυρώστε τα αποτελέσματα—συγκρίνετε ποιοτικά τις εξόδους της παλιάς και της νέας έκδοσης

Σημεία πρόσβασης API (Endpoints)

Η xAI διατηρεί δύο κύρια σημεία πρόσβασης:

  • /v1/responses — το κύριο σημείο πρόσβασης, συνιστάται για όλα τα νέα έργα
  • /v1/chat/completions — το παλαιότερο σημείο πρόσβασης (legacy), διατηρείται για συμβατότητα με υπάρχοντες πελάτες

Το παλαιότερο σημείο πρόσβασης δεν λαμβάνει πλέον νέες λειτουργίες. Αν ξεκινάτε ένα νέο έργο, χρησιμοποιήστε αποκλειστικά το /v1/responses.

Βασικά σημεία

  • Τρεις μορφές: απλό ψευδώνυμο (σταθερό), ψευδώνυμο latest (αιχμής), καρφιτσωμένη έκδοση (αμετάβλητη)
  • Στην παραγωγή, χρησιμοποιήστε καρφιτσωμένες εκδόσεις για σταθερότητα
  • Στην ανάπτυξη, χρησιμοποιήστε ψευδώνυμα για να επωφελείστε από βελτιώσεις
  • Παρακολουθείτε τις ανακοινώσεις απόσυρσης και σχεδιάστε τις μεταβάσεις σας
  • Το συνιστώμενο σημείο πρόσβασης είναι το /v1/responses, όχι το /v1/chat/completions
  • Δοκιμάζετε πάντα τα prompts σας κατά τη μετάβαση εκδόσεων