Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Responses API vs Chat Completions: kodėl verta migruoti

Paskaita 2 iš 22 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Responses API vs Chat Completions
  2. Esminiai pokyčiai
  3. Sesijų valdymas serveryje
  4. Garantotas JSON, o ne tikėtinas JSON
  5. Funkcijų kvietimas ir srautinis perdavimas
  6. Greitos migracijos gidas
  7. Ar verta migruoti nedelsiant?
  8. Svarbiausi punktai

Responses API vs Chat Completions

„Chat Completions“ API daugelį metų buvo standartas, todėl internete vis dar gausu kodų, kurie jį naudoja. Tačiau nuo 2025 m. „OpenAI“ paskelbė jį pasenusiu (legacy) ir visiems naujiems projektams rekomenduoja naudoti „Responses API“. Šioje pamokoje palyginsime šias dvi sąsajas, sutelkdami dėmesį į skirtumus, kurie tiesiogiai veikia tavo kodą.

Esminiai pokyčiai

Naudojant „Chat Completions“, turėjai sukurti žinučių sąrašą ir su kiekvienu užklausimu siųsti visą tą sąrašą. Pokalbio būsena buvo saugoma tavo programoje, o ne serveryje:

from openai import OpenAI
client = OpenAI()

# Senas modelis — Chat Completions (pasenęs)
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“ sutrumpina tą patį kvietimą iki dviejų parametrų ir suteikia tiesioginę prieigą prie sugeneruoto teksto. Sistemos žinutė tampa parametru instructions, o turinio gavimui nebereikia naršyti per choices[0].message.content:

from openai import OpenAI
client = OpenAI()

# Naujas modelis — 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."

Sesijų valdymas serveryje

Tai suteikia didžiausią tiesioginę naudą. API palaiko pokalbio būseną, todėl tau tereikia nurodyti ankstesnį atsakymą pagal jo ID. Įsivaizduok pagalbos asistentą: dešimtojo keitimosi metu „Chat Completions“ metodas vertė iš naujo siųsti devynis ankstesnius keitimus, vadinasi, vėl mokėjai už tuos tokenus. Čia pakanka vieno lauko:

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

# Antras klausimas — kontekstas išsaugomas automatiškai
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."

Garantotas JSON, o ne tikėtinas JSON

Antras didelis patobulinimas susijęs su struktūruota išvestimi. Tu apibūdini pageidaujamą formatą, o „Responses API“ garantuoja, kad atsakymas atitiks tavo JSON schemą – tai leidžia duomenis deserializuoti be papildomų apsaugos mechanizmų. Registracijos forma, išgryninanti informaciją iš laisvo teksto, nebežlugs vien todėl, kad modelis nusprendė prieš JSON pridėti įžanginį sakinį:

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}

Funkcijų kvietimas ir srautinis perdavimas

Įrankių deklaravimas laikosi to paties supaprastinimo principo: funkcijos aprašas deklaruojamas tiesiai tools masyve, o modelio prašomas kvietimas atsiranda tiesiai response.output, be papildomų įdėtų lygmenų.

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 grąžina funkcijos kvietimą vykdyti tiesiogiai
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"}

Srautinis perdavimas (streaming) nebegražina nediferencijuotų fragmentų srauto, o tipizuotus įvykius. Filtruoji pagal event.type ir tiksliai žinai, su kuo dirbi – ar tai teksto fragmentas, funkcijos argumentas, ar generavimo pabaiga:

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)

Greitos migracijos gidas

Chat CompletionsResponses API
client.chat.completions.create()client.responses.create()
messages=[...]input="..." arba input=[...]
response.choices[0].message.contentresponse.output_text
Rankinė istorijaprevious_response_id
response_formattext={"format": {...}}
tools + tool_choicetools (supaprastinta)

Ar verta migruoti nedelsiant?

„Chat Completions“ API vis dar veikia ir nėra šalinamas. Esamas kodas, kuris veikia, nereikalauja pakeitimų ir remiasi senąjį formatą naudojančia testavimo grandine, iš skubaus perrašymo nieko nelaimės. Panašiai, jei priklausai nuo trečiosios šalies bibliotekos, kuri dar nepalaiko „Responses API“, palauk jos atnaujinimo. Tačiau bet kuriam naujam projektui atsakymas aiškus: „Responses API“ yra startinis taškas, ir toliau šiame kurse remiamės būtent šia prielaida.

Svarbiausi punktai

  • „Responses API“ pakeičia „Chat Completions“ paprastesne sąsaja
  • Sesijų valdymas serveryje panaikina poreikį iš naujo siųsti istoriją
  • Struktūruota išvestis ir funkcijų kvietimai yra integruoti natūraliai
  • Migracija yra paprasta: koncepcijos lieka tos pačios, keičiasi tik sintaksė