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

Sreabhadh Oibre Asincronach agus Polling

Ceacht 10 as 12 Nuashonraithe 2 Samhain 2026 Meánleibhéal
Ar an leathanach seo
  1. Tuiscint a fháil ar shaolré an fhíseáin
  2. Seiceáil stádas na giniúna
  3. Trí stádas, trí ghníomh
  4. Polláil a chur i bhfeidhm
  5. Socraigh an t-eatramh pollála
  6. Príomhphointí

Nuashonraithe an 2 Samhain, 2026. Bunaithe ar thagairt API Físeáin xAI: faightear an URL i video.url (ní video_url), níl ach trí stádas ag giniúint (pending, done, failed, an ceann deireanach le cód earráide), agus sloinntear teorainneacha ráta in iarratais in aghaidh an tsoicind bunaithe ar leibhéal an fhoirne. Foinse: Giniúint Físeáin · Tagairt Físeáin · Teorainneacha Ráta.

Tuiscint a fháil ar shaolré an fhíseáin

Tá gach oibríocht físeáin san API xAI asincronach, agus cruthaíonn an tréith seo d’ailtireacht feidhmchláir níos mó ná mar a shamhlófá ar dtús. Tugann glao comhrá nó giniúint íomhá toradh láithreach; áfach, teastaíonn am próiseála suntasach ó ghiniúint físeáin agus ní thugann sí ach admháil. Is ortsa atá sé rianú a chur i bhfeidhm: déan stádas na tasc a fhiosrú go tréimhsiúil, braith an chríochnú, agus faigh an comhad. Tá an timthriall iomlán comhdhéanta de cheithre chéim.

1

Seol an t-iarratas

POST chuig an bpointe deiridh giniúna, eagarthóireachta, nó sínte. Freagra láithreach le request_id.

2

Polláil an stádas

GET /v1/videos/{request_id} ag eatraimh rialta. Réimse progress ó 0 go 100.

3

Faigh an toradh

Nuair a bhíonn an stádas done (progress = 100), tá URL an fhíseáin ar fáil.

4

Íosluchtaigh láithreach

Tá URL an fhíseáin sealadach. Íosluchtaigh é chomh luath agus is féidir.

Seiceáil stádas na giniúna

Baineann rianú le hiarratas GET simplí chuig an bpointe deiridh stádais, ag baint úsáide as an aitheantóir a fuarthas nuair a seoladh an t-iarratas.

curl "https://api.x.ai/v1/videos/vid_abc123def456" \
  -H "Authorization: Bearer $XAI_API_KEY"

Nochtann an freagra an fhaisnéis úsáideach seo a leanas:

  • status : stádas reatha na giniúna
  • progress : slánuimhir ó 0 go 100 a léiríonn an dul chun cinn
  • video.url : URL an fhíseáin, laistigh den oibiacht video atá i láthair nuair a bhíonn an stádas done, lena fhad (video.duration)
  • video.respect_moderation : booleán a léiríonn an bhfuil an t-ábhar i gcomhréir leis an bpolasaí measúnaithe
  • error : i gcás teipe, cód (invalid_argument, permission_denied, failed_precondition, service_unavailable, nó internal_error) agus teachtaireacht
  • usage.cost_in_usd_ticks : costas an iarratais, i ndeichiú-billiúnaí de dhollar

Is fiú nóta a thabhairt ar an réimse progress: ní stiúrann sé do loighic rialaithe, ar chóir brath i gcónaí ar status, ach tá sé luachmhar d’aghaidh úsáideora. Taispeáint “62%” in ionad snámhán statach athraíonn go hiomlán an tuiscint ar fhanacht a mhairfidh roinnt nóiméad.

Trí stádas, trí ghníomh

StádasDul chun cinnBrí
pending0-99Giniúint ar siúl
done100Críochnaithe, URL ar fáil
failedas láthairTheip ar an nginiúint

Fad is atá an stádas pending, leanann an ghiniúint ar aghaidh: ní dhéanann tú ach fiosrú ag eatraimh rialta, agus an progress a chur ar aghaidh chuig d’aghaidh úsáideora. Nuair a athraíonn sé go done, tá an físeán réidh, agus ní gá duit ach video.url a léamh agus an comhad a íosluchtú láithreach—tá na URLanna seo sealadach agus ní shonraíonn an doiciméadú a saolré, rud a chuireann cosc orthu a stóráil i mbunachar sonraí le haghaidh úsáide ina dhiaidh sin.

Ar deireadh, léiríonn an stádas failed teip léiriúcháin, agus insíonn an réimse error duit cé acu teip é. Tá tábhacht leis an idirdhealú maidir leis an méid a leanas: údar le service_unavailable (seirbhís ró-ualaithe go sealadach) nó internal_error chun iarracht arís níos déanaí, ach éilíonn invalid_argument nó permission_denied—leid diúltaithe, íomhá foinse nó físeán neamhbhailí—ceartú an iarratais ar dtús. Maidir leis an SDK Python, cuireann sé in iúl freisin trí earráid iarratas moillithe a d’éag sular aisghabháladh é.

Polláil a chur i bhfeidhm

Oireann an leagan sioncronach d’aon fheidhm amháin. Déanann sé lúbadh go dtí an t-am-teorainn, scoireann go luath i gcás teipe trí a chód a ardú, agus filleann sé an URL chomh luath agus atá an físeán réidh.

import httpx
import time

def attendre_video(request_id, api_key, timeout=600, intervalle=5):
    """Fan go gcríochnófar giniúint an fhíseáin."""
    headers = {"Authorization": f"Bearer {api_key}"}
    debut = time.time()

    while time.time() - debut < timeout:
        resp = httpx.get(
            f"https://api.x.ai/v1/videos/{request_id}",
            headers=headers
        ).json()

        status = resp.get("status")
        progress = resp.get("progress", 0)

        if status == "done":
            return resp["video"]["url"]
        elif status == "failed":
            erreur = resp.get("error", {})
            raise RuntimeError(f"Generation failed [{erreur.get('code')}] : {erreur.get('message')}")

        print(f"In progress... {progress}%")
        time.sleep(intervalle)

    raise TimeoutError(f"Timeout after {timeout} seconds")

I seirbhís a láimhseálann iarratais iolracha ag an am céanna, éiríonn an leagan blocála seo ina bhacainn: fanann gach feitheamh snáithe gan ghluaiseacht ar feadh nóiméad. Scaoileann an trasuí asincronach an lúb imeachta idir fiosruithe agus ligeann sé duit dosaen giniúint a rianú go comhthreomhar.

import httpx
import asyncio

async def attendre_video_async(request_id, api_key, timeout=600, intervalle=5):
    """Leagan asincronach den pholláil."""
    headers = {"Authorization": f"Bearer {api_key}"}
    async with httpx.AsyncClient() as client:
        debut = asyncio.get_event_loop().time()

        while asyncio.get_event_loop().time() - debut < timeout:
            resp = await client.get(
                f"https://api.x.ai/v1/videos/{request_id}",
                headers=headers
            )
            data = resp.json()

            if data["status"] == "done":
                return data["video"]["url"]
            elif data["status"] == "failed":
                raise RuntimeError(f"Generation failed : {data.get('error')}")

            await asyncio.sleep(intervalle)

    raise TimeoutError("Timeout")

Socraigh an t-eatramh pollála

Cothromaíonn roghnú an eatraimh freagrúlacht in aghaidh iarratais dramhaíola. Is comhréiteach maith é cúig shoicind i bhformhór na gcásanna. I gcás giniúintí fada—deich go cúig shoicind déag d’fhíseán—is leor deich go cúig shoicind déag idir pollálacha agus laghdaíonn sé an trácht. Os a choinne sin, údar le feidhmchlár idirghníomhach ina bhfuil an t-úsáideoir ag breathnú ar bharra dul chun cinn titim go dtí dhá nó trí shoicind. Faoi bhun soicind amháin, áfach, ní luasóidh tú aon rud: leanann an ghiniúint ar aghaidh ar a luas féin, agus ní dhéanann tú ach iarratais a iolrú gan ghá.

Príomhphointí

  • Tá gach oibríocht físeáin asincronach: POST chun seoladh, GET chun aisghabháil
  • Trí stádas is féidir a bheith ann: pending, done, failed (le cód earráide)
  • Ligeann an réimse progress (0-100) duit an dul chun cinn a rianú
  • Cuir am-teorainn agus eatramh pollála i bhfeidhm atá oiriúnach do do chás úsáide
  • Tá URLanna físeáin sealadach: íosluchtaigh iad láithreach