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

Responses API vs Chat Completions: Γιατί να κάνετε μετάβαση

Μάθημα 2 / 22 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Responses API vs Chat Completions
  2. Θεμελιώδεις Αλλαγές
  3. Διαχείριση Συνεδρίας στον Διακομιστή
  4. Εγγυημένο JSON, όχι «Ελπίζουμε για» JSON
  5. Κλήση Συναρτήσεων και Ροή Δεδομένων (Streaming)
  6. Οδηγός Γρήγορης Μετάβασης
  7. Να κάνετε άμεση μετάβαση;
  8. Βασικά σημεία

Responses API vs Chat Completions

Το Chat Completions API υπηρέτησε ως πρότυπο για χρόνια και μεγάλο μέρος του κώδικα που βρίσκετε online το χρησιμοποιεί ακόμα. Ωστόσο, από το 2025, η OpenAI το έχει χαρακτηρίσει ως παρωχημένο (legacy) και συνιστά το Responses API για όλα τα νέα έργα. Αυτό το μάθημα συγκρίνει τις δύο διεπαφές, εστιάζοντας στις διαφορές που επηρεάζουν πραγματικά τον κώδικά σας.

Θεμελιώδεις Αλλαγές

Με το Chat Completions, δημιουργούσατε μια λίστα μηνυμάτων και στέλνατε ολόκληρη τη λίστα με κάθε κλήση. Η κατάσταση της συνομιλίας ζούσε στην εφαρμογή σας, ποτέ στον διακομιστή:

from openai import OpenAI
client = OpenAI()

# Old model — Chat Completions (legacy)
response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "What is the capital of France?"},
    ]
)
print(response.choices[0].message.content)
# Result: "The capital of France is Paris."

Το Responses API ανάγει την ίδια κλήση σε δύο παραμέτρους και παρέχει άμεση πρόσβαση στο παραγόμενο κείμενο. Το μήνυμα συστήματος γίνεται η παράμετρος instructions, και η εξαγωγή περιεχομένου δεν απαιτεί πλέον πλοήγηση μέσω του choices[0].message.content:

from openai import OpenAI
client = OpenAI()

# New model — Responses API
response = client.responses.create(
    model="gpt-5.6-terra",
    input="What is the capital of France?"
)
print(response.output_text)
# Result: "The capital of France is Paris."

Διαχείριση Συνεδρίας στον Διακομιστή

Αυτό προσφέρει το πιο άμεσο όφελος. Το API διατηρεί την κατάσταση της συνομιλίας, οπότε χρειάζεται απλώς να αναφέρεστε στην προηγούμενη απάντηση μέσω του ID της. Φανταστείτε έναν βοηθό υποστήριξης: κατά τη δέκατη εναλλαγή, η προσέγγιση του Chat Completions σας ανάγκαζε να ξαναστείλετε τις προηγούμενες εννέα ανταλλαγές, σημαίνοντας ότι πληρώνατε ξανά για αυτά τα tokens. Εδώ, αρκεί ένα μόνο πεδίο:

# First question
response = client.responses.create(
    model="gpt-5.6-terra",
    input="My name is Marie."
)

# Second question — context is preserved automatically
followup = client.responses.create(
    model="gpt-5.6-terra",
    input="What is my name?",
    previous_response_id=response.id
)
print(followup.output_text)
# Result: "Your name is Marie."

Εγγυημένο JSON, όχι «Ελπίζουμε για» JSON

Η δεύτερη μεγάλη βελτίωση αφορά τη δομημένη έξοδο. Περιγράφετε την αναμενόμενη μορφή και το Responses API εγγυάται ότι η απάντηση θα τηρεί το σχήμα JSON σας—επιτρέποντάς σας να κάνετε deserialization χωρίς δικλείδες ασφαλείας. Μια φόρμα εγγραφής που εξάγει πληροφορίες από ελεύθερο κείμενο δεν «σπάει» πλέον απλώς και μόνο επειδή το μοντέλο αποφασίζει να προσθέσει μια εισαγωγική πρόταση πριν από το JSON του:

from pydantic import BaseModel

class City(BaseModel):
    name: str
    country: str
    population: int

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Give me information about Paris.",
    text={"format": {"type": "json_schema", "json_schema": {
        "name": "city",
        "strict": True,
        "schema": City.model_json_schema()
    }}}
)
print(response.output_text)
# Result: {"name": "Paris", "country": "France", "population": 2161000}

Κλήση Συναρτήσεων και Ροή Δεδομένων (Streaming)

Η δήλωση εργαλείων ακολουθεί την ίδια λογική απλοποίησης: ο περιγραφέας της συνάρτησης δηλώνεται επίπεδα στα tools, και η κλήση που ζητά το μοντέλο εμφανίζεται απευθείας στο response.output, χωρίς επιπλέον επίπεδα εμφώλευσης.

response = client.responses.create(
    model="gpt-5.6-terra",
    input="What is the weather like in Lyon?",
    tools=[{
        "type": "function",
        "name": "get_meteo",
        "description": "Get the weather for a city",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string", "description": "Name of the city"}
            },
            "required": ["city"]
        }
    }]
)

# The API returns the function call to execute directly
for item in response.output:
    if item.type == "function_call":
        print(f"Function: {item.name}, Arguments: {item.arguments}")
# Result: Function: get_meteo, Arguments: {"city": "Lyon"}

Το streaming δεν επιστρέφει πλέον μια ροή αδιάκριτων τμημάτων, αλλά τυποποιημένα γεγονότα. Φιλτράρετε βάσει του event.type και γνωρίζετε ακριβώς τι διαχειρίζεστε—ένα τμήμα κειμένου, ένα όρισμα συνάρτησης ή το τέλος της παραγωγής:

stream = client.responses.create(
    model="gpt-5.6-terra",
    input="Tell a short story.",
    stream=True
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)

Οδηγός Γρήγορης Μετάβασης

Chat CompletionsResponses API
client.chat.completions.create()client.responses.create()
messages=[...]input="..." ή input=[...]
response.choices[0].message.contentresponse.output_text
Χειροκίνητο ιστορικόprevious_response_id
response_formattext={"format": {...}}
tools + tool_choicetools (απλοποιημένο)

Να κάνετε άμεση μετάβαση;

Το Chat Completions API παραμένει λειτουργικό και δεν πρόκειται να καταργηθεί. Ο υπάρχων κώδικας που εκτελείται, δεν απαιτεί αλλαγές και βασίζεται σε μια δοκιμαστική ροή εργασίας χτισμένη γύρω από την παλιά μορφή, δεν κερδίζει τίποτα από μια επείγουσα ξαναγραφή. Ομοίως, αν εξαρτάστε από μια βιβλιοθήκη τρίτου κατασκευαστή που δεν υποστηρίζει ακόμα το Responses API, περιμένετε την ενημέρωσή της. Ωστόσο, για οποιοδήποτε νέο έργο, η απάντηση είναι ξεκάθαρη: το Responses API είναι το σημείο εκκίνησης και το υπόλοιπο αυτού του μαθήματος προχωρά με αυτή την παραδοχή.

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

  • Το Responses API αντικαθιστά το Chat Completions με μια απλούστερη διεπαφή
  • Η διαχείριση συνεδρίας στον διακομιστή εξαλείφει την ανάγκη επαναστολής του ιστορικού
  • Η Δομημένη Έξοδος και η κλήση συναρτήσεων είναι ενσωματωμένες εγγενώς
  • Η μετάβαση είναι απλή: οι έννοιες παραμένουν ίδιες, αλλάζει μόνο η σύνταξη