Láimhseáil Earráidí agus Cóid HTTP
Ar an leathanach seo
Nuashonraithe an 3 Samhain, 2026 bunaithe ar dhoiciméadú OpenAI: níl
temperatureagustop_pinghlactha ach le hiarracht réasúnaíochta (reasoning effort) denone, cé go ndéanann samhlacha GPT-5.6 réasúnú go huathoibríoch (medium). Caithfidh glaonna a shocraíonn na paraiméadair seoreasoning={"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-turboanois, 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ód | Eisceacht | Iarracht arís? | Gníomh |
|---|---|---|---|
| 400 | BadRequestError | Ní hea | Ceartaigh an t-iarratas |
| 401 | AuthenticationError | Ní hea | Fíoraigh eochair API |
| 403 | PermissionDeniedError | Ní hea | Fíoraigh ceadanna |
| 404 | NotFoundError | Ní hea | Fíoraigh samhail/nascphointe |
| 422 | UnprocessableEntityError | Ní hea | Ceartaigh an fhormáid |
| 429 | RateLimitError | Is ea | Cúlú easpónantúil |
| 500 | InternalServerError | Is ea | Fan agus déan iarracht arís |
| 503 | InternalServerError | Is ea | Seirbhí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_retriesmás gá