Μεταβατική μετάβαση στο Responses API
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026: Η αντιστοίχιση παραμέτρων υποδείκνυε προηγουμένως ότι το
max_tokensδιατηρεί το όνομά του στο Responses API· ο πίνακας της xAI το αλλάζει σεmax_output_tokens, ενώ αλλάζουν και τα ονόματα των μετρητών χρήσης. Πηγή: Σύγκριση με το Chat Completions.
Γιατί και πότε να κάνετε τη μετάβαση
Το endpoint του Chat Completions έχει χαρακτηριστεί ως παρωχημένο (legacy). Θα συνεχίσει να λειτουργεί, αλλά δεν θα προστεθούν νέες λειτουργίες σε αυτό. Εάν η εφαρμογή σας χρειάζεται εργαλεία πλευράς διακομιστή (αναζήτηση στον ιστό, εκτέλεση κώδικα), αποθήκευση συνομιλιών ή κρυπτογραφημένο συλλογισμό, η μετάβαση στο Responses API καθίσταται απαραίτητη.
Τα καλά νέα: αυτή η μετάβαση μπορεί να γίνει σταδιακά. Δεν χρειάζεται να ξαναγράψετε τα πάντα ταυτόχρονα.
Βήμα 1: Εντοπίστε τις λειτουργίες που χρησιμοποιείτε
Πριν προχωρήσετε στη μετάβαση, αποτυπώστε τι χρησιμοποιεί η εφαρμογή σας με το Chat Completions:
# Ελέγξτε τον υπάρχοντα κώδικά σας
# Αναζητήστε τα εξής μοτίβα:
# 1. Βασικές κλήσεις (απλό κείμενο)
client.chat.completions.create(model=..., messages=...)
# 2. Ροή δεδομένων (Streaming)
client.chat.completions.create(..., stream=True)
# 3. Κλήση συναρτήσεων (Function calling)
client.chat.completions.create(..., tools=[...])
# 4. Όραση (εικόνες)
# messages με content ως πίνακα [text, image_url]
# 5. Παράμετροι παραγωγής
# temperature, max_tokens, top_p, stop, seed
Οι βασικές κλήσεις και η ροή δεδομένων είναι οι πιο απλές στη μετάβαση. Η κλήση συναρτήσεων απαιτεί προσαρμογή της μορφής. Η όραση λειτουργεί με παρόμοιο τρόπο.
Βήμα 2: Μεταβάστε τις βασικές κλήσεις
Η μετάβαση μιας απλής κλήσης ακολουθεί αυτό το μοτίβο:
# ΠΡΙΝ — 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!"}
]
)
texte = response.choices[0].message.content
# ΜΕΤΑ — Responses API
response = client.responses.create(
model="grok-4.20-0309-reasoning",
instructions="You are a helpful assistant.",
input="Hello!"
)
texte = response.output_text
Αντιστοίχιση πεδίων
Οι κύριες αλλαγές είναι:
messagesμε ρόλοsystem→instructions(αφιερωμένη παράμετρος)messagesμε ρόλοuser→input(απλή συμβολοσειρά)response.choices[0].message.content→response.output_textmax_tokens→max_output_tokens, σύμφωνα με τον πίνακα αντιστοίχισης της xAI· τοtemperatureδιατηρεί το όνομά τουresponse.usage.prompt_tokensκαιcompletion_tokens→input_tokensκαιoutput_tokens(λεπτομέρειες:input_tokens_details.cached_tokens,output_tokens_details.reasoning_tokens)
Βήμα 3: Μεταβάστε τις συνομιλίες πολλαπλών γύρων
Εδώ είναι που το Responses API απλοποιεί τα πράγματα. Αντί να ανακατασκευάζετε το ιστορικό με κάθε αίτημα, τις αλυσιδώνετε μέσω ID:
# ΠΡΙΝ — Chat Completions (διαχειρίζεστε μόνοι σας το ιστορικό)
historique = [
{"role": "system", "content": "You are a helpful assistant."}
]
def envoyer_message(texte: str) -> str:
historique.append({"role": "user", "content": texte})
response = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=historique
)
reponse = response.choices[0].message.content
historique.append({"role": "assistant", "content": reponse})
return reponse
# ΜΕΤΑ — Responses API (ο διακομιστής διαχειρίζεται το ιστορικό)
dernier_id = None
def envoyer_message(texte: str) -> str:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
instructions="You are a helpful assistant.",
input=texte,
previous_response_id=dernier_id
)
dernier_id = response.id
return response.output_text
Ο κώδικας είναι απλούστερος και δεν χρειάζεται πλέον να διαχειρίζεστε χειροκίνητα τον πίνακα μηνυμάτων.
Βήμα 4: Εκμεταλλευτείτε τις νέες λειτουργίες
Μόλις ολοκληρώσετε τη μετάβαση, μπορείτε να αξιοποιήσετε λειτουργίες αποκλειστικές του Responses API:
Ενσωματωμένη αναζήτηση στον ιστό
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest developments in generative AI?",
tools=[{"type": "web_search"}]
)
# Η απάντηση περιλαμβάνει παραπομπές με URLs πηγών
Αποθήκευση απάντησης
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze this document...",
store=True # Διατηρείται για 30 ημέρες
)
# Ανάκτηση αργότερα
stored = client.responses.retrieve(response.id)
Κρυπτογραφημένος συλλογισμός
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Solve this complex problem...",
include=["reasoning.encrypted_content"]
)
# Ο κρυπτογραφημένος συλλογισμός μπορεί να επαναχρησιμοποιηθεί σε επόμενα αιτήματα
Συνιστώμενη στρατηγική μετάβασης
Αντί να μεταβάσετε τα πάντα ταυτόχρονα, προχωρήστε βήμα-βήμα:
- Εντοπίστε τις κλήσεις Chat Completions στον κώδικά σας
- Κατηγοριοποιήστε τες ανά πολυπλοκότητα (βασικές → streaming → κλήση συναρτήσεων)
- Μεταβάστε πρώτα τα νέα endpoints ή λειτουργίες (greenfield)
- Στη συνέχεια μεταβάστε τις απλούστερες υπάρχουσες κλήσεις
- Διατηρήστε το Chat Completions για ενσωματώσεις τρίτων που το απαιτούν (LangChain, κ.λπ.)
Προσωρινή συνύπαρξη
Είναι απολύτως αποδεκτό να εκτελείτε και τα δύο endpoints παράλληλα κατά τη διάρκεια της μετάβασης:
# Wrapper που αφαιρεί την εξάρτηση από το endpoint που χρησιμοποιείται
class GrokClient:
def __init__(self, use_responses: bool = False):
self.use_responses = use_responses
self.client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
def generate(self, system: str, user_message: str) -> str:
if self.use_responses:
response = self.client.responses.create(
model="grok-4.20-0309-reasoning",
instructions=system,
input=user_message
)
return response.output_text
else:
response = self.client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "system", "content": system},
{"role": "user", "content": user_message}
]
)
return response.choices[0].message.content
Αυτή η προσέγγιση σάς επιτρέπει να κάνετε τη μετάβαση σταδιακά, δοκιμάζοντας κάθε μεταβολή ξεχωριστά.
Βασικά σημεία
- Η μετάβαση μπορεί να είναι σταδιακή: δεν χρειάζεται να ξαναγράψετε τα πάντα ταυτόχρονα
- Κύριες αλλαγές:
messages→input/instructions,choices[0].message.content→output_text - Οι συνομιλίες πολλαπλών γύρων μεταφέρονται από έναν πίνακα μηνυμάτων σε ένα απλό
previous_response_id - Το Responses API παρέχει πρόσβαση σε αποκλειστικές λειτουργίες (web_search, αποθήκευση, κρυπτογραφημένος συλλογισμός)
- Εκτελέστε και τα δύο endpoints παράλληλα κατά τη μετάβαση και μεταβείτε με σειρά πολυπλοκότητας
Δοκιμάστε τις γνώσεις σας
Το παρωχημένο API κατανοήθηκε — και η μετάβαση προετοιμάστηκε.
1. Τι σημαίνει η κατάσταση legacy και stateless του Chat Completions;
Απάντηση: Το endpoint παραμένει υποστηριζόμενο αλλά δεν εξελίσσεται πλέον: ως stateless, απαιτεί την επαναποστολή ολόκληρου του ιστορικού με κάθε κλήση — το Responses API είναι ο σύγχρονος δρόμος.
2. Ποιοι ρόλοι δομούν τα μηνύματα;
Απάντηση: system (και developer), user, assistant — το πλαίσιο, τα αιτήματα, οι απαντήσεις: ολόκληρο το ιστορικό επανεκκινεί με κάθε αίτημα.
3. Πώς χρησιμοποιείτε υπάρχοντα κώδικα OpenAI με το Grok;
Απάντηση: Αλλάζοντας το base_url σε https://api.x.ai/v1 και το κλειδί API — η συμβατότητα μορφής αναλαμβάνει τα υπόλοιπα, συμπεριλαμβανομένων των OpenAI SDK και Vercel AI SDK.
4. Τι διαβάζετε στην απάντηση και στη χρήση;
Απάντηση: Το choices μεταφέρει απαντήσεις με finish_reason· το usage λεπτομερεί τα tokens, συμπεριλαμβανομένων των reasoning_tokens για μοντέλα συλλογισμού — η βάση για την παρακολούθηση κόστους.
5. Πώς μεταβαίνετε καθαρά στο Responses API;
Απάντηση: Σταδιακά: νέες αναπτύξεις στο Responses, υπάρχοντα endpoints μετατρέπονται ένα προς ένα με επαναδοκιμή prompt — η σύγκριση των δύο μορφών καθοδηγεί τη μετατροπή.
Κατανοήστε το παρωχημένο, χτίστε για το σύγχρονο: το σχέδιο σταδιακής μετάβασης του μαθήματος είναι ο οδικός χάρτης σας — χωρίς «μεγάλη έκρηξη».