Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

API Responses vs Chat Completions: Cén fáth le haistriú

Ceacht 2 as 22 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. API Responses vs Chat Completions
  2. Athruithe Bunúsacha
  3. Bainistíocht Seisiún ar an bhFreastalaí
  4. JSON Ráthaithe, Seachas JSON ar Dhóchas
  5. Glao Feidhme agus Sruthú
  6. Treoir Aistrithe Tapaidh
  7. Ar chóir duit aistriú láithreach?
  8. Príomhphointí

API Responses vs Chat Completions

Ba é an Chat Completions API an caighdeán ar feadh blianta, agus úsáideann an chuid is mó den chód a fheiceann tú ar líne é fós. Mar sin féin, ó 2025 i leith, tá OpenAI tar éis é a ainmniú mar seanbhunaithe (legacy) agus molann siad an API Responses do gach tionscadal nua. Déanann an ceacht seo comparáid idir an dá chomhéadan, ag díriú ar na difríochtaí a imríonn tionchar iarbhír ar do chód.

Athruithe Bunúsacha

Le Chat Completions, chruthaigh tú liosta teachtaireachtaí agus sheol tú an liosta iomlán le gach glao. Bhí staid an chomhrá ina chónaí i d’fheidhmchlár, riamh ar an bhfreastalaí:

from openai import OpenAI
client = OpenAI()

# Seanmhúnla — Chat Completions (seanbhunaithe)
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)
# Toradh: "The capital of France is Paris."

Laghdaíonn an API Responses an glao céanna seo go dtí dhá pharaiméadar agus soláthraíonn sé rochtain dhíreach ar an téacs ginte. Éiríonn an teachtaireacht chórais ina paraiméadar instructions, agus ní gá a thuilleadh dul trí choices[0].message.content chun ábhar a bhaint amach:

from openai import OpenAI
client = OpenAI()

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

Bainistíocht Seisiún ar an bhFreastalaí

Soláthraíonn sé seo an tairbhe is láithrí. Coinníonn an API staid an chomhrá, mar sin ní gá duit ach an freagra roimhe sin a thagairt trína ID. Samhlaigh cúntóir tacaíochta: faoin deichiú babhta, d’éiligh cur chuige Chat Completions ort na nao mbabhta roimhe sin a athsheoladh, rud a chiallaigh gur íoc tú as na tocainí sin arís. Anseo, is leor réimse amháin:

# An chéad cheist
response = client.responses.create(
    model="gpt-5.6-terra",
    input="My name is Marie."
)

# An dara ceist — caomhnaítear an comhthéacs go huathoibríoch
followup = client.responses.create(
    model="gpt-5.6-terra",
    input="What is my name?",
    previous_response_id=response.id
)
print(followup.output_text)
# Toradh: "Your name is Marie."

JSON Ráthaithe, Seachas JSON ar Dhóchas

Baineann an dara feabhsúchán mór le haschur struchtúrtha. Déanann tú cur síos ar an bhformáid a bhfuiltear ag súil léi, agus ráthaíonn an API Responses go gcomhlíonann an freagra do scéma JSON—rud a ligeann duit díshreangú gan aon líonraí sábháilteachta. Ní bhriseann foirm clárúcháin a eastósann faisnéis ó théacs saor in aisce a thuilleadh díreach toisc go gcinneann an múnla abairt réamhrá a chur lena 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)
# Toradh: {"name": "Paris", "country": "France", "population": 2161000}

Glao Feidhme agus Sruthú

Leanann dearbhú uirlisí an loighic shimplithe céanna: dearbhaítear an tuairisceoir feidhme go cothrom in tools, agus feictear an glao a d’iarr an múnla go díreach in response.output, gan leibhéil bhreise neadaithe.

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"]
        }
    }]
)

# Filleann an API an glao feidhme le cur i gcrích go díreach
for item in response.output:
    if item.type == "function_call":
        print(f"Function: {item.name}, Arguments: {item.arguments}")
# Toradh: Function: get_meteo, Arguments: {"city": "Lyon"}

Ní thugann sruthú a thuilleadh sruth de smután gan idirdhealú ach imeachtaí de chineál sonrach. Scagann tú ar event.type agus tá a fhios agat go beacht cad atá á láimhseáil agat—blúire téacs, argóint feidhme, nó deireadh na giniúna:

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)

Treoir Aistrithe Tapaidh

Chat CompletionsAPI Responses
client.chat.completions.create()client.responses.create()
messages=[...]input="..." nó input=[...]
response.choices[0].message.contentresponse.output_text
Stair láimheprevious_response_id
response_formattext={"format": {...}}
tools + tool_choicetools (simplithe)

Ar chóir duit aistriú láithreach?

Tá an Chat Completions API fós feidhmiúil agus ní bhaintear é. Ní bhaineann cód atá ann cheana a oibríonn, nach éilíonn aon athruithe, agus a bhraitheann ar phíblíne tástála tógtha timpeall an tseanfhormáid, aon tairbhe as athscríobh práinneach. Mar an gcéanna, má bhraitheann tú ar leabharlann tríú páirtí nach dtacaíonn leis an API Responses fós, fan lena nuashonrú. Mar sin féin, d’aon tionscadal nua, tá an freagra soiléir: is é an API Responses an pointe tosaigh, agus leanann an chuid eile den chúrsa ón mbunús sin.

Príomhphointí

  • Cuireann an API Responses Chat Completions ar ceal le comhéadan níos simplí
  • Cuireann bainistíocht seisiún ar an bhfreastalaí deireadh leis an ngá stair a athsheoladh
  • Tá Aschur Struchtúrtha agus glao feidhme comhtháite go dúchasach
  • Tá an t-aistriú simplí: fanann na coincheapa mar an gcéanna, ní athraíonn ach an chomhréir