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

Láimhseáil Earráidí agus Cóid HTTP

Ceacht 12 as 22 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Láimhseáil Earráidí agus Cóid HTTP
  2. Cóid HTTP API OpenAI
  3. Láimhseálaí Earráidí Cuimsitheach
  4. Earráidí Sonracha API Freagraí
  5. Logáil Struchtúrtha Earráidí
  6. Tábla Achoimre
  7. Príomhphointí

Nuashonraithe an 3 Samhain, 2026 bunaithe ar dhoiciméadú OpenAI: níl temperature agus top_p inghlactha ach le hiarracht réasúnaíochta (reasoning effort) 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.

Soiléirithe an 3 Samhain, 2026 bunaithe ar leathanach Dí-úsáidithe OpenAI: d’úsáid an sampla samhla a baineadh roimhe gpt-4o, atá ar fáil fós go dtí an 14 Eanáir, 2027; úsáideann sé gpt-4-turbo anois, a scoradh ar an 23 Deireadh Fómhair, 2026 (an t-ionadaí a tugadh le fios: gpt-5.6-sol). Foinse: Dí-úsáidithe.

Láimhseáil Earráidí agus Cóid HTTP

I dtimpeallacht táirgeachta, tá earráidí dosheachanta. Titann an líonra, téann eochair API in éag, déanann comhghleacaí paraiméadar neamhbhailí a imlonnú, nó bíonn briseadh trí nóiméad ag an API féin. Tá sé ríthábhachtach na cóid HTTP a thugtar ar ais ag an API a thuiscint agus iad a láimhseáil i gceart chun feidhmchláir láidre a thógáil. Tagann an dúshlán iomlán anuas ar cheist amháin ar cheart duit a chur do gach eisceacht: an rachaidh sé seo in éag má dhéanaim iarracht arís, nó an mbeidh mé i lúb gan deireadh ar fhadhb nach féidir ach le duine daonna a shocrú?

Cóid HTTP API OpenAI

Tugann an API cóid HTTP chaighdeánacha ar ais chun toradh gach iarratais a léiriú. Ní ligeann an Python SDK duit na cóid seo a láimhseáil de láimh; ina ionad sin, aistríonn sé gach ceann acu go heisceacht chlóscríofa is féidir leat a ghabháil ar leith. Ligeann sé seo duit blocanna except cruinne a scríobh seachas except Exception uileghabhálach a chuirfeadh nádúr na faidhbe i bhfolach.

from openai import OpenAI
from openai import (
    APIError,
    AuthenticationError,
    BadRequestError,
    RateLimitError,
    APIConnectionError,
    InternalServerError,
    PermissionDeniedError,
    NotFoundError,
    UnprocessableEntityError,
)

client = OpenAI()

401 — AuthenticationError

Léiríonn 401 nach bhfuil an eochair API bailí nó go bhfuil sí in easnamh. Feiceann tú é seo de ghnáth le linn na chéad imlonnaithe nuair nach bhfuil an athróg timpeallachta scaipthe chuig an gcoimeádán. Níl aon mhaith in iarracht arís: beidh an eochair chomh neamhbhailí céanna deich soicind as seo amach.

try:
    # Eochair API neamhbhailí nó in easnamh
    bad_client = OpenAI(api_key="sk-invalid")
    bad_client.responses.create(
        model="gpt-5.6-terra",
        input="Test"
    )
except AuthenticationError as e:
    print(f"Cód: {e.status_code}")  # 401
    print(f"Teachtaireacht: {e.message}")
    # Gníomh: fíoraigh an eochair API, athghin más gá

400 — BadRequestError

Inseoidh 400 duit go bhfuil an t-iarratas míchumtha. Anseo, soláthraítear teocht (temperature) de 5.0 nuair gurb é 2.0 an luach uasta a nglactar leis. Ainmníonn an teachtaireacht earráide an paraiméadar lochtach beagnach i gcónaí, rud a fhágann gurb é seo an earráid is tapúla le socrú—ar choinníoll go ndéanann tú logáil air i gceart seachas é a shlogadh go ciúin.

try:
    # Paraiméadair neamhbhailí
    client.responses.create(
        model="gpt-5.6-terra",
        reasoning={"effort": "none"},  # éilíonn temperature iarracht none
        input="Test",
        temperature=5.0  # Luach neamhbhailí (uas 2.0)
    )
except BadRequestError as e:
    print(f"Cód: {e.status_code}")  # 400
    print(f"Teachtaireacht: {e.message}")
    # Gníomh: ceartaigh paraiméadair an iarratais

429 — RateLimitError

Léiríonn 429 go bhfuil tú ag seoladh an iomarca iarratas nó go bhfuil do chuóta sáraithe agat. Murab ionann agus an dá cheann roimhe seo, tá an earráid seo sealadach ó nádúr: athshocraíonn an t-áireamh. Is é seo an cás leabhair téacs le haghaidh iarracht arís, ach iarracht a fhanann—agus a fhanann níos faide le gach iarracht.

try:
    # An iomarca iarratas nó cuóta sáraithe
    client.responses.create(
        model="gpt-5.6-terra",
        input="Test"
    )
except RateLimitError as e:
    print(f"Cód: {e.status_code}")  # 429
    print(f"Teachtaireacht: {e.message}")
    # Gníomh: fan agus déan iarracht arís le cúlú easpónantúil

500/503 — InternalServerError

Tagann earráidí 500 agus 503 ó OpenAI, ní uaitse. Bhí d’iarratas bailí; níorbh fhéidir leis an mbonneagar é a phróiseáil. Déan iarracht arís tar éis moille: sa chuid is mó de chásanna, éiríonn leis an dara nó an tríú hiarracht.

try:
    client.responses.create(
        model="gpt-5.6-terra",
        input="Test"
    )
except InternalServerError as e:
    print(f"Cód: {e.status_code}")  # 500 nó 503
    print(f"Teachtaireacht: {e.message}")
    # Gníomh: déan iarracht arís tar éis moille; tá an earráid ar thaobh OpenAI

Láimhseálaí Earráidí Cuimsitheach

Tabhair na hiompraíochtaí seo le chéile i bhfeidhm amháin. Is triage an loighic: déantar earráidí marfacha a thiontú go RuntimeError agus ardaítear iad láithreach, spreagann earráidí sealadacha fanacht a dhéanann dúbailt gach uair, agus má ídítear an buiséad iarrachta, teipeann ar an nglao go glan seachas luach folamh a thabhairt ar ais a d’fhéadfadh an glaodóir a míthuiscint.

from openai import OpenAI, APIError, AuthenticationError, RateLimitError
from openai import BadRequestError, APIConnectionError, InternalServerError
import time

client = OpenAI()

def robust_api_call(prompt: str, model: str = "gpt-5.6-terra",
                    max_retries: int = 3) -> str:
    """Glao API le láimhseáil chuimsitheach earráidí."""

    for attempt in range(max_retries):
        try:
            response = client.responses.create(
                model=model,
                input=prompt
            )
            return response.output_text

        except AuthenticationError:
            # Ná déan iarracht arís — tá an eochair neamhbhailí
            raise RuntimeError("Eochair API neamhbhailí. Seiceáil OPENAI_API_KEY.")

        except BadRequestError as e:
            # Ná déan iarracht arís — tá an t-iarratas míchumtha
            raise RuntimeError(f"Iarratas neamhbhailí: {e.message}")

        except RateLimitError:
            # Déan iarracht arís le cúlú easpónantúil
            delay = 2 ** attempt
            print(f"Sroicheadh teorainn ráta. Ag fanacht {delay}s...")
            time.sleep(delay)

        except InternalServerError:
            # Déan iarracht arís — earráid taobh freastalaí
            delay = 2 ** attempt
            print(f"Earráid freastalaí. Iarracht {attempt + 1}/{max_retries}...")
            time.sleep(delay)

        except APIConnectionError:
            # Déan iarracht arís — fadhb líonra
            delay = 2 ** attempt
            print(f"Earráid nascachta. Iarracht {attempt + 1}/{max_retries}...")
            time.sleep(delay)

    raise RuntimeError(f"Theip tar éis {max_retries} iarracht")

# Úsáid
try:
    result = robust_api_call("Hello!")
    print(result)
except RuntimeError as e:
    print(f"Earráid mharfach: {e}")

Earráidí Sonracha API Freagraí

Tá dhá chás a thuilleann cóireáil ar leith toisc go mbíonn siad le feiceáil faoi chód ginearálta ach go n-éilíonn siad socrú an-sonrach.

Comhthéacs Rófhada

Filleann leid a sháraíonn fuinneog an chomhthéacs 400, díreach cosúil le botún cló i bparaiméadar. Chun idirdhealú a dhéanamh idir an dá cheann, scrúdaigh an teachtaireacht: léiríonn láithreacht context_length_exceeded duit i dtreo an téacs a ghearradh nó aistriú go samhail le fuinneog chomhthéacs níos mó, seachas do pharaiméadair a athbhreithniú.

try:
    response = client.responses.create(
        model="gpt-5.6-terra",
        input="x " * 300000  # Sáraíonn sé fuinneog an chomhthéacs
    )
except BadRequestError as e:
    if "context_length_exceeded" in str(e.message):
        print("Tá an leid rófhada don tsamhail seo.")
        print("Réitigh: gearr an téacs, nó athraigh go samhail")
        print("le fuinneog chomhthéacs níos mó.")

Samhail Neamh-infheidhme

Níl aitheantóirí samhlacha síoraí. Teipeann ar imlonnú a thagraíonn fós do shamhail scortha le 404, rud a fhágann go dtiteann an feidhmchlár iomlán in éag cé gur oibrigh sé an lá roimhe sin. Láimhseáil an cás seo go sainráite: is meabhrúchán uathoibríoch é do chumraíocht a nuashonrú.

try:
    response = client.responses.create(
        model="gpt-4-turbo",  # scortha ón API ar an 23 Deireadh Fómhair, 2026
        input="Test"
    )
except NotFoundError as e:
    print(f"Níor aimsíodh an tsamhail: {e.message}")
    print("Úsáid gpt-5.6-sol, an t-ionadaí a thug OpenAI le fios, nó samhail níos nuaí.")

Logáil Struchtúrtha Earráidí

Is earráid í earráid nach ndéantar logáil uirthi a fhionnfaidh tú trí thicéad custaiméara. Athraíonn logáil i JSON seachas i dtéacs saor gach rud nuair a bhíonn gá le comhiomlánú: is féidir leat 429 a chomhaireamh in aghaidh na huaire, scagadh de réir response_id, nó claonadh tomhaltais a rianú, rud atá dodhéanta le línte loga lámhscríofa.

import logging
import json
from datetime import datetime

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger("openai_client")

def call_with_log(prompt: str) -> str:
    """Glao API le logáil struchtúrtha."""
    request_id = None

    try:
        response = client.responses.create(
            model="gpt-5.6-terra",
            input=prompt
        )

        logger.info(json.dumps({
            "event": "api_success",
            "model": response.model,
            "tokens": response.usage.total_tokens,
            "response_id": response.id,
            "timestamp": datetime.now().isoformat()
        }))

        return response.output_text

    except APIError as e:
        logger.error(json.dumps({
            "event": "api_error",
            "status_code": e.status_code,
            "message": e.message,
            "timestamp": datetime.now().isoformat()
        }))
        raise

result = call_with_log("Hello!")

Tábla Achoimre

Coinnigh an ghreille seo i láimh: déanann sí achoimre ar an gcinneadh atá le déanamh do gach cód.

CódEisceachtIarracht arís?Gníomh
400BadRequestErrorNí heaCeartaigh an t-iarratas
401AuthenticationErrorNí heaFíoraigh eochair API
403PermissionDeniedErrorNí heaFíoraigh ceadanna
404NotFoundErrorNí heaFíoraigh samhail/nascphointe
422UnprocessableEntityErrorNí heaCeartaigh an fhormáid
429RateLimitErrorIs eaCúlú easpónantúil
500InternalServerErrorIs eaFan agus déan iarracht arís
503InternalServerErrorIs eaSeirbhís ar fáil go sealadach

Príomhphointí

  • Déan catagóiriú ar earráidí: in-athiarrtha (429, 500, 503) vs marfach (400, 401, 403)
  • Úsáid cúlú easpónantúil le haghaidh earráidí in-athiarrtha
  • Ná déan iarracht arís ar earráidí fíordheimhniúcháin nó iarratais neamhbhailí
  • Déan logáil ar gach earráid le comhthéacs (cód, teachtaireacht, stampa ama)
  • Láimhseálann an SDK 2 iarracht go huathoibríoch — cumraigh max_retries más gá