AsyncOpenAI le httpx.Timeout
Ar an leathanach seo
Rogha eile don SDK OpenAI
Ní hé SDK dúchasach xAI an t-aon rogha atá agat le haghaidh oibre neamhshioncrónaí leis an API Grok. Oibríonn an SDK OpenAI, a úsáidtear go forleathan sa chóras éiceolaíochta Python, leis an API xAI mar gheall ar chomhoiriúnacht formáide. Ligeann an cur chuige seo duit cód OpenAI atá ann cheana a athúsáid agus leas a bhaint as an éiceachóras uirlisí máguaird.
Cumraigh AsyncOpenAI do xAI
Éilíonn an tionscnaimh trí pharaiméadar: do eochair API, an bun-URL xAI, agus teorainn ama coigeartaithe do mhúnlaí réasúnaíochta:
from openai import AsyncOpenAI
import httpx
client = AsyncOpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
timeout=httpx.Timeout(3600.0)
)
Is é httpx.Timeout(3600.0) an mhionsonraí tábhachtach anseo. Úsáideann an SDK OpenAI httpx mar a chliant HTTP bunúsach, agus is é 10 nóiméad an teorainn ama réamhshocraithe. I gcás múnlaí réasúnaíochta Grok, ní mór duit é seo a mhéadú go 3600 soicind (uair an chloig) chun dícheangail phréamhacha a sheachaint.
Tuig httpx.Timeout
Glacann an rang httpx.Timeout le roinnt paraiméadar a rialaíonn céimeanna éagsúla den nasc:
# Teorainn ama aonfhoirmeach: 3600s do gach rud
timeout = httpx.Timeout(3600.0)
# Teorainn ama ghraiméireach
timeout = httpx.Timeout(
connect=10.0, # teorainn ama don nasc tosaigh
read=3600.0, # teorainn ama chun an freagra a léamh
write=30.0, # teorainn ama chun an t-iarratas a sheoladh
pool=10.0 # am feithimh le haghaidh nasc saor
)
Sa táirgeadh, is féidir leat na luachanna seo a bheachtú. Ba chóir go dteipfeadh ar an nasc tosaigh go tapa mura bhfuil an freastalaí inrochtana (tá 10 soicind leordhóthanach), ach ní mór don teorainn ama léitheoireachta a bheith foighneach go leor le fanacht le réasúnaíocht an mhúnla.
Seol Iarratais
Leanann an chomhréir formáid chaighdeánach an SDK OpenAI, ag úsáid await:
import asyncio
async def query_grok(prompt: str) -> str:
response = await client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[{"role": "user", "content": prompt}]
)
return response.choices[0].message.content
result = asyncio.run(query_grok("What are the advantages of Rust over C++?"))
Feicfidh tú an struchtúr céanna leis an API OpenAI: eagar messages le róil agus ábhar. Leanann an freagra an scéama céanna, atá inrochtana trí response.choices[0].message.content.
Láimhseáil Earráidí le httpx
Soláthraíonn an SDK OpenAI le httpx eisceachtaí sonracha ar gá duit iad a ghabháil:
from openai import APITimeoutError, APIConnectionError, RateLimitError
async def safe_query(prompt: str) -> str | None:
try:
response = await client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[{"role": "user", "content": prompt}]
)
return response.choices[0].message.content
except APITimeoutError:
print("Sáraíodh an teorainn ama—thóg an t-iarratas ró-fhada")
return None
except RateLimitError:
print("Sroicheadh an teorainn ráta—moilligh ar na hiarratais")
return None
except APIConnectionError:
print("Ní féidir nasc a dhéanamh le freastalaí xAI")
return None
Is iad APITimeoutError (níor fhreagair an múnla laistigh den am ceadaithe), RateLimitError (sháraigh tú teorainneacha RPM/TPM), agus APIConnectionError (fadhb líonra) na trí eisceacht is coitianta.
Cathain a Roghnaíonn tú AsyncOpenAI seachas an SDK xAI
Is fearr an SDK OpenAI má tá bonn cód OpenAI agat cheana, má úsáideann tú uirlisí tríú páirtí atá comhoiriúnach le OpenAI (LangChain, LiteLLM), nó má theastaíonn uait athrú idir soláthraithe gan do chód a mhodhnú. Tugann an SDK xAI dúchasach, áfach, rochtain níos díreachí ar ghnéithe sonracha Grok, cosúil le huirlisí ionsuite.
Príomhphointí
- Oibríonn
AsyncOpenAIleis an API xAI tríbase_url="https://api.x.ai/v1" - Teastaíonn
httpx.Timeout(3600.0)do mhúnlaí réasúnaíochta - Tá formáid an iarrtais agus na freagra comhionann leis an API OpenAI caighdeánach
- Clúdaíonn na heisceachtaí
APITimeoutError,RateLimitError, agusAPIConnectionErrorna príomhchásanna earráide - Is rogha idéalach é seo chun cód atá ann cheana a athúsáid nó uirlisí tríú páirtí atá comhoiriúnach le OpenAI a chomhtháthú