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

Do Chéad Ghlaó ar an API

Ceacht 5 as 22 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Do Chéad Ghlaó ar an API
  2. An Glaó is Simplí
  3. Cad atá sa Fhreagra i ndáiríre
  4. Na Paraiméadair a Chuireann Athrú Air
  5. Ag Bogadh go dtí Ionchur Struchtúrtha
  6. Ná Fág Glaó Gan Chosaint Riamh
  7. Príomhphointí

An ceacht nuashonraithe an 3 Samhain, 2026 bunaithe ar dhoiciméadú OpenAI: ní ghlactar le temperature agus top_p ach le hiarracht réasúnaíochta de none, cé go ndéanann samhlacha GPT-5.6 réasúnú go huathoibríoch (medium). Caithfidh glaonna a shocraíonn na paraiméadair seo reasoning={"effort": "none"} (API Freagraí) nó reasoning_effort="none" (Críochnú Comhrá) a shonrú dá bhrí sin. Foinse: GPT-6 a úsáid · GPT-5.6 Terra.

Do Chéad Ghlaó ar an API

Tá do thimpeallacht réidh: déanaimis obair. Tá tú ar tí do chéad ghlaó a dhéanamh ar an API Freagraí, an oibiacht a thugtar ar ais a mhiondealú, agus ansin na paraiméadair a láimhseáil a dhéanann idirdhealú idir freagra ginearálta agus ceann úsáideach.

An Glaó is Simplí

Níl de dhíth ort ach dhá pharaiméadar: model, an t-aithneoir don tsamhail atá le fiosrú, agus input, do leid—cibé acu teaghrán téacs nó liosta teachtaireachtaí, mar a fheicfidh tú go luath.

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-5.6-terra",
    input="What is the difference between Python and JavaScript?"
)

print(response.output_text)
# Result: Python is a versatile language oriented toward data science
# and backend development, while JavaScript is primarily used for
# frontend and backend web development (via Node.js)...

Cad atá sa Fhreagra i ndáiríre

Is aicearra áisiúil é output_text amháin. Iompraíonn an oibiacht response a haitheantóir uathúil féin freisin—riachtanach chun malartuithe a shlabhrú agus glaonna a lorg i do logaí—, an tsamhail iarbhír a úsáideadh, agus briseadh síos ar thomhaltas tocain. Déan cleachtas de na trí phíosa eolais seo a logáil ó do chéad scripteanna. Is é seo a chuirfidh ar do chumas an cheist a fhreagairt níos déanaí: “Cén fáth ar dúbailt an bille an mhí seo?”

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Hello, how are you?"
)

# The response text (shortcut)
print(response.output_text)

# The unique ID of the response
print(f"ID: {response.id}")

# The model used
print(f"Model: {response.model}")

# Tokens consumed
print(f"Input tokens: {response.usage.input_tokens}")
print(f"Output tokens: {response.usage.output_tokens}")
print(f"Total tokens: {response.usage.total_tokens}")

# Result:
# Hello! I'm doing very well, thank you. How can I help you?
# ID: resp_abc123xyz
# Model: gpt-5.6-terra
# Input tokens: 14
# Output tokens: 19
# Total tokens: 33

Na Paraiméadair a Chuireann Athrú Air

Rialaíonn temperature inathraitheacht na giniúna. Ag 0.0, roghnaíonn an tsamhail an leanúint is dóichí go córasach: seo an socrú do cheisteanna fíriciúla, eastóscadh sonraí, agus aon rud a theastaíonn uait a atáirgeadh go hionann. Ag 1.0, déanann sí iniúchadh níos forleithne, rud atá uait le haghaidh ainmniú, scríbhneoireacht chruthaitheach, nó leaganacha éagsúla a ghiniúint.

# Low temperature (0.0) = deterministic, factual
response_factual = client.responses.create(
    model="gpt-5.6-terra",
    reasoning={"effort": "none"},  # temperature requires effort none
    input="What is the capital of Germany?",
    temperature=0.0
)
print(response_factual.output_text)
# Result: The capital of Germany is Berlin.

# High temperature (1.0) = creative, varied
response_creative = client.responses.create(
    model="gpt-5.6-terra",
    reasoning={"effort": "none"},  # temperature requires effort none
    input="Invent a name for a literary café.",
    temperature=1.0
)
print(response_creative.output_text)
# Result: "The Wandering Pages"—a café where every table bears
# the name of a famous chapter.

Líonann an paraiméadar instructions ról an tsean-teachtaireachta córais: sainíonn sé an ról, an tón, agus na srianta ar cheart don tsamhail cloí leo ar fud an mhalartaithe, beag beann ar an gceist a chuirtear. Sa sampla thíos, tháirgfí liosta de leideanna ginearálta dá gcuirfí an cheist chéanna gan treoracha; leo, táirgtear oideas.

response = client.responses.create(
    model="gpt-5.6-terra",
    instructions="You are an expert in French cuisine. "
                 "Always respond with recipe suggestions.",
    input="I don't know what to do with zucchini."
)
print(response.output_text)
# Result: Here are three ideas for your zucchini:
# 1. Zucchini gratin with goat cheese...
# 2. Provençal ratatouille...
# 3. Cold zucchini velouté with mint...

Ar deireadh, cuireann max_output_tokens teorainn le fad na freagra. Cosaint bhuiséadach atá ann seo, ní treoir scríbhneoireachta: gearrtar an fhreagra go tobann a luaithe a shroicheann an teorainn. Má theastaíonn freagra gairid, dea-chumtha uait, iarr é sin sa leid freisin.

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Explain general relativity.",
    max_output_tokens=100
)
print(response.output_text)
print(f"Tokens used: {response.usage.output_tokens}")
# The response will be truncated at approximately 100 tokens

Ag Bogadh go dtí Ionchur Struchtúrtha

Nuair nach leor teaghrán simplí, glacann input le liosta teachtaireachtaí. Tá casadh amháin sa fhoirm íosta, ach feictear an tairbhe a luaithe a chuireann tú stair ar fáil: bíonn rochtain ag an tsamhail ansin ar an méid a ráiteadh cheana agus freagraíonn sí dá réir. Anseo, tuigtear “dul chun cinn” i gcomhthéacs Python, ní go teibí.

response = client.responses.create(
    model="gpt-5.6-terra",
    input=[
        {
            "role": "user",
            "content": "Translate to English: Hello world"
        }
    ]
)
print(response.output_text)
# Result: Hello world

# With conversation context
response = client.responses.create(
    model="gpt-5.6-terra",
    input=[
        {
            "role": "user",
            "content": "My favorite language is Python."
        },
        {
            "role": "assistant",
            "content": "Python is an excellent choice! It is very versatile."
        },
        {
            "role": "user",
            "content": "Give me a tip to improve."
        }
    ]
)
print(response.output_text)
# Result: To improve in Python, I recommend that you...

Ná Fág Glaó Gan Chosaint Riamh

Teipeann ar ghlaonna líonra, agus téann eochracha in éag. Clúdaíonn trí eisceacht an chuid is mó de chásanna agus tú ag tosú amach: AuthenticationError le haghaidh eochair atá in easnamh nó neamhbhailí, RateLimitError nuair a sháraíonn tú an tréchur ceadaithe, agus APIError mar líon sábháilteachta ginearálta. Tiocfaidh ceacht iomlán ar ais ar an straitéis iomlán, ach ó inniu amach, cuimsigh do ghlaonna.

from openai import OpenAI, APIError, AuthenticationError, RateLimitError

client = OpenAI()

try:
    response = client.responses.create(
        model="gpt-5.6-terra",
        input="Hello!"
    )
    print(response.output_text)
except AuthenticationError:
    print("Error: Invalid or missing API key")
except RateLimitError:
    print("Error: Too many requests, wait a moment")
except APIError as e:
    print(f"API Error: {e.message}")

Chun an t-iomlán a dhaingniú, scríobh script a iarrann trí cheist agus a charnaíonn na tocain a úsáideadh. Comhcheanglóidh tú an lúb glaonna, teocht de 0.0 le haghaidh freagraí cobhsaí, agus léamh usage—na trí fhrithghníomh bhunúsacha.

from openai import OpenAI

client = OpenAI()

questions = [
    "What is the largest ocean in the world?",
    "Who painted the Mona Lisa?",
    "How many planets are in the solar system?"
]

total_tokens = 0

for question in questions:
    response = client.responses.create(
        model="gpt-5.6-terra",
        reasoning={"effort": "none"},  # temperature requires effort none
        input=question,
        temperature=0.0
    )
    tokens = response.usage.total_tokens
    total_tokens += tokens
    print(f"Q: {question}")
    print(f"A: {response.output_text}")
    print(f"   ({tokens} tokens)\n")

print(f"Total: {total_tokens} tokens consumed")

Príomhphointí

  • Níl de dhíth ar ghlaó bunúsach ach model agus input
  • Soláthraíonn response.output_text téacs na freagra
  • Mionsonraíonn response.usage tomhaltas tocain
  • Rialaíonn temperature an chruthaitheacht (0.0 = fíriciúil, 1.0 = cruthaitheach)
  • Athsholáthraíonn instructions an teachtaireacht chórais ó Chríochnú Comhrá
  • Láimhseáil earráidí i gcónaí le blocanna try/except