Responses API vs Chat Completions: miks üle minna
Sellel lehel
Responses API vs Chat Completions
Chat Completions API oli aastaid standardiks ja suurem osa veebist leitavast koodist kasutab endiselt seda. Alates 2025. aastast on OpenAI aga määranud selle iganenuks (legacy) ja soovitab kõigi uute projektide jaoks Responses API-d. See tund võrdleb kahte liidest, keskendudes erinevustele, mis mõjutavad tegelikult sinu koodi.
Põhimõttelised muudatused
Chat Completionsiga lõid sõnumite loendi ja saatsid iga väljakutsega kogu loendi uuesti. Vestluse olek elas sinu rakenduses, mitte serveris:
from openai import OpenAI
client = OpenAI()
# Vana mudel — Chat Completions (iganenud)
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)
# Tulemus: "The capital of France is Paris."
Responses API taandab sama väljakutse kahele parameetrile ja annab otsese juurdepääsu genereeritud tekstile. Süsteemi sõnum muutub parameetriks instructions ja sisu ekstrahtimiseks ei pea enam navigeerima läbi choices[0].message.content:
from openai import OpenAI
client = OpenAI()
# Uus mudel — Responses API
response = client.responses.create(
model="gpt-5.6-terra",
input="What is the capital of France?"
)
print(response.output_text)
# Tulemus: "The capital of France is Paris."
Serveripoolne seansihaldus
See pakub kõige kiiremat kasu. API haldab vestluse olekut, nii et pead eelmisele vastusele viitamiseks kasutama vaid selle ID-d. Kujuta ette tugiteenuse assistenti: kümnenda pöörde ajaks sundis Chat Completionsi lähenemine sind saatma uuesti eelmisi üheksat vahetust, mis tähendas, et maksid nende tokenite eest uuesti. Siin piisab ühest väljast:
# Esimene küsimus
response = client.responses.create(
model="gpt-5.6-terra",
input="My name is Marie."
)
# Teine küsimus — kontekst säilib automaatselt
followup = client.responses.create(
model="gpt-5.6-terra",
input="What is my name?",
previous_response_id=response.id
)
print(followup.output_text)
# Tulemus: "Your name is Marie."
Garanteeritud JSON, mitte lootusrikas JSON
Teine suur paranemine puudutab struktureeritud väljundit. Kirjeldad oodatavat formaati ja Responses API garanteerib, et vastus järgib sinu JSON skeemi – see võimaldab deserialiseerida ilma täiendavate turvamehhanismideta. Registreerimisvorm, mis ekstraheerib teavet vabast tekstist, ei katki enam lihtsalt sellepärast, et mudel otsustab enne oma JSON-i lisada sissejuhatava lause:
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)
# Tulemus: {"name": "Paris", "country": "France", "population": 2161000}
Funktsioonide kutsumine ja voogedastus
Tööriistade deklareerimine järgib sama lihtsustamise loogikat: funktsiooni kirjeldus deklareeritakse tasapinnaliselt võtmes tools ja mudeli taotletud väljakutse ilmub otse väärtusesse response.output, ilma täiendavate pesastustasemeteta.
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"]
}
}]
)
# API tagastab täitmiseks mõeldud funktsioonikutse otse
for item in response.output:
if item.type == "function_call":
print(f"Function: {item.name}, Arguments: {item.arguments}")
# Tulemus: Function: get_meteo, Arguments: {"city": "Lyon"}
Voogedastus ei tagasta enam eristamatute tükkide voogu, vaid tüübitud sündmusi. Filtreerid põhjal event.type ja tead täpselt, millega tegemist on – kas tekstifragmendi, funktsiooni argumendi või genereerimise lõpuga:
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)
Kiire migratsioonijuhend
| Chat Completions | Responses API |
|---|---|
client.chat.completions.create() | client.responses.create() |
messages=[...] | input="..." või input=[...] |
response.choices[0].message.content | response.output_text |
| Manuaalne ajalugu | previous_response_id |
response_format | text={"format": {...}} |
tools + tool_choice | tools (lihtsustatud) |
Kas peaksid kohe üle minema?
Chat Completions API jääb funktsionaalseks ja seda ei eemaldata. Olemasolev kood, mis töötab, ei vaja muudatusi ja tugineb vana formaadi ümber ehitatud testitorustikule, ei saa kiirustatud ümberkirjutamisest mingit kasu. Samuti, kui sõltud kolmanda osapoole teegist, mis veel ei toeta Responses API-d, oota selle uuendust. Igasuguse uue projekti puhul on vastus aga selge: Responses API on lähtepunkt ja ülejäänud kursus eeldab just seda.
Peamised punktid
- Responses API asendab Chat Completionsi lihtsama liidesega
- Serveripoolne seansihaldus kõrvaldab vajaduse saata ajalugu uuesti
- Struktureeritud väljund ja funktsioonide kutsumine on loomupäraselt integreeritud
- Migratsioon on sirgjooneline: kontseptsioonid jäävad samaks, muutub vaid süntaks