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

AsyncOpenAI le httpx.Timeout

Ceacht 2 as 12 Nuashonraithe 30 Iúil 2026 Ardleibhéal
Ar an leathanach seo
  1. Rogha eile don SDK OpenAI
  2. Cumraigh AsyncOpenAI do xAI
  3. Tuig httpx.Timeout
  4. Seol Iarratais
  5. Láimhseáil Earráidí le httpx
  6. Cathain a Roghnaíonn tú AsyncOpenAI seachas an SDK xAI
  7. Príomhphointí

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 AsyncOpenAI leis 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, agus APIConnectionError na 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ú