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

Σύγκριση Chat Completions και Responses API

Μάθημα 11 / 12 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Δύο τελικά σημεία, δύο φιλοσοφίες
  2. Διαχείριση κατάστασης: η θεμελιώδης διαφορά
  3. Αποκλειστικά εργαλεία και χαρακτηριστικά
  4. Πότε να χρησιμοποιήσετε το Chat Completions;
  5. Πότε να χρησιμοποιήσετε το Responses API;
  6. Βασικά σημεία

Δύο τελικά σημεία, δύο φιλοσοφίες

Η xAI προσφέρει δύο τελικά σημεία (endpoints) για αλληλεπίδραση με τα μοντέλα Grok: το Chat Completions (/v1/chat/completions) και το Responses API (/v1/responses). Η κατανόηση των διαφορών τους είναι απαραίτητη για να επιλέξετε το κατάλληλο τελικό σημείο για το έργο σας και να σχεδιάσετε οποιαδήποτε πιθανή μετάβαση.

Πτυχή Chat Completions API Responses
Κατάσταση Παλαιό (Legacy) Κύριο (συνιστάται)
Διαχείριση κατάστασης Χωρίς κατάσταση (αποστολή ιστορικού) Με κατάσταση (previous_response_id)
Αποθήκευση διακομιστή Όχι Ναι (30 ημέρες με store: true)
Συνομιλία Πίνακας μηνυμάτων Αλυσιδωτή μέσω ID
Εργαλεία διακομιστή Μόνο κλήση συναρτήσεων web_search, x_search, code_interpreter, functions
Κρυπτογραφημένη συλλογιστική Όχι Ναι (encrypted_content)
Νέα χαρακτηριστικά Δεν έχουν προτεραιότητα Έχουν προτεραιότητα
Συμβατότητα OpenAI Πλήρης Μερική

Διαχείριση κατάστασης: η θεμελιώδης διαφορά

Chat Completions: εσείς διαχειρίζεστε το ιστορικό

Με κάθε αίτημα, πρέπει να επαναστείλετε ολόκληρη τη συνομιλία:

# Chat Completions — επαναστολή των πάντων κάθε φορά
response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, my name is Alice."},
        {"role": "assistant", "content": "Hello Alice! How can I help you?"},
        {"role": "user", "content": "What is my first name?"}
    ]
)

Responses API: ο διακομιστής διαχειρίζεται το ιστορικό

Με το Responses API, ένας απλός αναγνωριστικός κωδικός αρκεί για να συνεχίσετε μια συνομιλία:

# Responses API — μόνο το ID της προηγούμενης απόκρισης
response1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Hello, my name is Alice."
)

response2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is my first name?",
    previous_response_id=response1.id
)

Ο διακομιστής διατηρεί το πλαίσιο και ανακατασκευάζει αυτόματα το ιστορικό. Δεν πληρώνετε λιγότερα tokens (το ιστορικό χρεώνεται κανονικά), αλλά απλοποιείτε τον κώδικά σας και μειώνετε το μέγεθος των αιτημάτων σας.

Αποκλειστικά εργαλεία και χαρακτηριστικά

Το Responses API παρέχει πρόσβαση σε εργαλεία διακομιστή που το Chat Completions δεν προσφέρει:

  • web_search: αναζήτηση στον ιστό σε πραγματικό χρόνο
  • x_search: αναζήτηση σε αναρτήσεις του X (Twitter)
  • code_interpreter: εκτέλεση κώδικα Python στην πλευρά του διακομιστή

Αυτά τα εργαλεία ενσωματώνονται απευθείας στο αίτημα:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is the latest news on AI?",
    tools=[{"type": "web_search"}]
)

Το Chat Completions υποστηρίζει την κλήση συναρτήσεων (εργαλεία που ορίζονται από τον προγραμματιστή), αλλά όχι αυτά τα εργαλεία διακομιστή που διαχειρίζεται η xAI.

Πότε να χρησιμοποιήσετε το Chat Completions;

Το Chat Completions παραμένει η σωστή επιλογή σε διάφορα σενάρια:

  • Μετάβαση από το OpenAI: ο υπάρχων κώδικάς σας λειτουργεί χωρίς σημαντικές τροποποιήσεις
  • Πολλαπλοί πάροχοι: θέλετε να εναλλάσσεστε μεταξύ OpenAI, Anthropic και xAI με τον ίδιο κώδικα
  • Πλαίσια τρίτων: τα LangChain, LlamaIndex, Haystack και τα περισσότερα πλαίσια χρησιμοποιούν τη μορφή Chat Completions
  • Πλήρης έλεγχος: θέλετε να διαχειρίζεστε εσείς το ιστορικό (συνοψίωση, φιλτράρισμα, τροποποίηση)

Πότε να χρησιμοποιήσετε το Responses API;

Το Responses API είναι προτιμότερο για:

  • Νέα έργα: επωφεληθείτε από τα τελευταία χαρακτηριστικά από την αρχή
  • Εργαλεία διακομιστή: ανάγκη για αναζήτηση στον ιστό, εκτέλεση κώδικα ή αναζήτηση στο X
  • Μακρές συνομιλίες: δεν χρειάζεται να επαναστέλνετε το ιστορικό με κάθε αίτημα
  • Κρυπτογραφημένη συλλογιστική: πρόσβαση στο περιεχόμενο συλλογιστικής για συνέχεια μεταξύ αιτημάτων

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

  • Το Chat Completions είναι χωρίς κατάσταση (εσείς διαχειρίζεστε το ιστορικό), ενώ το Responses API είναι με κατάσταση (ο διακομιστής διαχειρίζεται)
  • Το Responses API προσφέρει αποκλειστικά εργαλεία διακομιστή: web_search, x_search, code_interpreter
  • Το Chat Completions έχει πλήρη συμβατότητα με το OpenAI, ενώ το Responses API είναι ειδικό για την xAI
  • Και τα δύο τελικά σημεία χρεώνουν ολόκληρο το ιστορικό της συνομιλίας
  • Χρησιμοποιήστε το Chat Completions για συμβατότητα και το Responses API για νέα χαρακτηριστικά