Κατάσταση Legacy και η Αρχή του Stateless
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026 με βάση τις βέλτιστες πρακτικές της xAI: Η xAI πλέον χαρακτηρίζει το Chat Completions ως deprecated και συνιστά το Responses API για τα μοντέλα συλλογισμού Grok. Ο συγκεκριμένος λόγος είναι ότι το Chat Completions δεν διαθέτει πεδίο για τον κρυπτογραφημένο συλλογισμό του μοντέλου, με αποτέλεσμα κάθε συνομιλία πολλαπλών γύρων ή κλήση εργαλείου να χάνει τον συλλογισμό από τους προηγούμενους γύρους. Τα νέα χαρακτηριστικά εισάγονται επίσης πρώτα στο Responses API. Πηγές: xAI Best Practices · Chat Completions (legacy).
Το Endpoint Chat Completions στο Οικοσύστημα της xAI
Το API της xAI προσφέρει δύο κύρια endpoints για αλληλεπίδραση με τα μοντέλα Grok: το Responses API (κύριο endpoint) και το endpoint Chat Completions. Το τελευταίο χαρακτηρίζεται ως legacy: παραμένει πλήρως λειτουργικό, αλλά τα νέα χαρακτηριστικά δίνουν πλέον προτεραιότητα στο Responses API.
Γιατί να σας ενδιαφέρει τότε; Επειδή το Chat Completions παραμένει το πιο ευρέως υιοθετημένο endpoint στο οικοσύστημα. Όλα τα υπάρχοντα SDK της OpenAI, frameworks όπως το LangChain ή το LlamaIndex, και χιλιάδες tutorials χρησιμοποιούν αυτή τη μορφή. Αν μεταβαίνετε από άλλο πάροχο ή εργάζεστε με εργαλεία τρίτων, αυτό είναι πιθανότατα το endpoint που θα χρησιμοποιήσετε πρώτο.
Ένα Stateless Endpoint: Στέλνετε Τα Πάντα με Κάθε Αίτημα
Η θεμελιώδης αρχή του Chat Completions είναι ότι είναι stateless: ο διακομιστής δεν διατηρεί κανένα ιστορικό συνομιλίας. Με κάθε κλήση, πρέπει να συμπεριλάβετε ολόκληρο το ιστορικό των προηγούμενων μηνυμάτων στο αίτημά σας.
Συγκεκριμένα, αυτό σημαίνει ότι για μια συνομιλία με 10 ανταλλαγές, το 11ο αίτημά σας πρέπει να περιέχει τα 10 προηγούμενα μηνύματα (χρήστη + βοηθού) συν το νέο μήνυμα. Η εφαρμογή σας διαχειρίζεται αυτό το ιστορικό.
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"},
{"role": "assistant", "content": "Hello! How can I help you?"},
{"role": "user", "content": "Explain deep learning to me."}
]
}
Σε αυτό το παράδειγμα, τα πρώτα τρία μηνύματα αντιπροσωπεύουν το ιστορικό συνομιλίας. Μόνο το τελευταίο είναι το νέο μήνυμα του χρήστη. Το μοντέλο χρειάζεται όλο αυτό το πλαίσιο για να παράγει μια συνεκτική απάντηση.
Πρακτικές Επιπτώσεις
Αυτή η stateless προσέγγιση έχει αρκετές επιπτώσεις:
- Πλήρης έλεγχος: εσείς αποφασίζετε ακριβώς ποια μηνύματα στέλνονται στο μοντέλο. Μπορείτε να φιλτράρετε, να συνοψίζετε ή να τροποποιείτε το ιστορικό πριν από κάθε κλήση.
- Ανάλογο κόστος: κάθε αίτημα χρεώνεται για όλα τα tokens που στέλνονται, συμπεριλαμβανομένου του ιστορικού. Όσο μεγαλύτερη είναι η συνομιλία, τόσο πιο ακριβή γίνεται κάθε ανταλλαγή.
- Χωρίς επιμονή στον διακομιστή: κανένα δεδομένο δεν αποθηκεύεται στην πλευρά της xAI μεταξύ των αιτημάτων. Αυτό αποτελεί πλεονέκτημα για την ιδιωτικότητα, αλλά απαιτεί από εσάς να διαχειριστείτε την επιμονή μόνοι σας.
Σύγκριση με το Responses API
Το Responses API, αντιθέτως, είναι stateful: διατηρεί το ιστορικό στην πλευρά του διακομιστή μέσω του previous_response_id. Δεν χρειάζεται να ξαναστείλετε τα προηγούμενα μηνύματα· αρκεί ένα απλό αναγνωριστικό. Οι απαντήσεις μπορούν να αποθηκευτούν έως και 30 ημέρες με store: true.
Η επιλογή μεταξύ των δύο εξαρτάται από την περίπτωση χρήσης σας. Αν εργάζεστε με ένα υπάρχον SDK της OpenAI ή μεταβαίνετε από άλλο πάροχο, το Chat Completions είναι το λογικό σημείο εκκίνησης. Για ένα νέο έργο, συνιστάται το Responses API.
Βασικά σημεία
- Το Chat Completions χαρακτηρίζεται ως legacy αλλά παραμένει πλήρως λειτουργικό και συμβατό με το οικοσύστημα της OpenAI
- Το endpoint είναι stateless: πρέπει να ξαναστέλνετε ολόκληρο το ιστορικό με κάθε αίτημα
- Το κόστος κάθε αιτήματος περιλαμβάνει όλα τα tokens του ιστορικού
- Το Responses API προσφέρει μια stateful εναλλακτική με επιμονή στην πλευρά του διακομιστή
- Για τα μοντέλα συλλογισμού, συνιστάται ένα timeout 3600 δευτερολέπτων