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

xAI SDK agus Pollú Uathoibríoch

Ceacht 11 as 12 Nuashonraithe 2 Samhain 2026 Meánleibhéal
Ar an leathanach seo
  1. Simpligh an pollú leis an SDK
  2. Glao amháin in ionad lúibe
  3. Láimhseáil earráidí ag an bhfoinse
  4. Eagarthóireacht agus síneadh, an éascaíocht chéanna
  5. Ná fág físeán riamh sa scamall
  6. Giniúint ilfhíseáin ag an am céanna
  7. Ar chóir duit pollú láimhe a thréigean?
  8. Príomhphointí

Nuashonraithe an 2 Samhain, 2026 bunaithe ar dhoiciméadú físeáin xAI agus ar chód xai-sdk 1.21.0: is iad client.video.generate agus client.video.extend na modhanna (úsáideann eagarthóireacht generate le video_url, nochtann an toradh url, socraítear an mhoill trí timedelta, agus is é an t-eatramh pollaithe réamhshocraithe ná soicind amháin. Éilíonn await an cliant asioncronach AsyncClient, agus allmhairítear an eisceacht VideoGenerationError ó xai_sdk.video. Ghlaodh an seanleagan ar mhodhanna agus ar mhodúl eisceachta nach bhfuil ann. Foinse: Giniúint Físeáin · Eagarthóireacht Físeáin · Síneadh Físeáin · xai-sdk-python.

Simpligh an pollú leis an SDK

Chuir an ceacht roimhe seo ort lúb phollaithe a scríobh de láimh. Is cleachtadh úsáideach é chun timthriall na giniúna a thuiscint, ach is tríocha líne cóid atá le cothabháil i ngach tionscadal freisin, lena láimhseáil ama féin, cásanna teipe, agus tiontuithe stádais. Cuimsíonn SDK oifigiúil Python xAI (pip install xai-sdk) é seo go léir: seolann tú an t-iarratas, agus déanann sé feidhm as an bhfanacht.

Glao amháin in ionad lúibe

Grúpáiltear an t-iarratas, an rianú agus an aisghabháil sa mhodh client.video.generate. Ní thugann sé smacht ar ais ach nuair atá an físeán réidh, nó ardaíonn sé eisceacht má chuaigh rud éigin mícheart.

import os

import xai_sdk

client = xai_sdk.Client(api_key=os.getenv("XAI_API_KEY"))

# Giniúint téacs-go-físeán le pollú uathoibríoch
video = client.video.generate(
    prompt="Grianéirí thar na hAlpa, luas-amharc luasaithe",
    model="grok-imagine-video-1.5",
    duration=5,
    aspect_ratio="16:9",
    resolution="720p",
)

print(video.url)
print(f"Fad: {video.duration} s, múnla: {video.model}")

Taobh thiar de na línte beaga seo, déanann an SDK díreach an rud a rinne tú roimhe: an t-iarratas a sheoladh, stádas a phollú gach soicind de réir réamhshocraithe, agus ansin an toradh a thabhairt ar ais nó eisceacht a ardú ag brath ar an toradh.

Tá socruithe amháin ar chóir duit aird a thabhairt air láithreach ón imlonnú: de réir réamhshocraithe, fanann an SDK suas le 10 nóiméad sula n-éiríonn sé as. Tá sé sin compordach do script táirgeachta oíche, ach ró-fhada d’iarratas gréasáin áit a bhfuil úsáideoir ag fanacht le freagra. Socraíonn na paraiméadair timeout agus interval, araon ina n-ábhair timedelta, an teorainn agus an rithim:

from datetime import timedelta

video = client.video.generate(
    prompt="Do chur síos",
    model="grok-imagine-video-1.5",
    duration=10,
    timeout=timedelta(minutes=5),   # 5 nóiméad ar a mhéad
    interval=timedelta(seconds=5),  # seiceáil amháin gach 5 soicind
)

Má theastaíonn uait smacht a choinneáil ar an bhfanacht – chun dul chun cinn a chur ar aghaidh, mar shampla – seolann client.video.start an t-iarratas agus filleann sé a request_id, a ndéanann client.video.get ceist air ina dhiaidh sin.

Láimhseáil earráidí ag an bhfoinse

Déanann an SDK idirdhealú idir teipeanna, rud a shábhálann ort anailís a dhéanamh ar shreingeanna chun a fháil amach cad a tharla:

from xai_sdk.video import VideoGenerationError

try:
    video = client.video.generate(
        prompt="Do chur síos",
        model="grok-imagine-video-1.5",
        duration=5,
    )
    print(f"Físeán réidh: {video.url}")
except VideoGenerationError as e:
    print(f"Theip ar an nginiúint [{e.code}]: {e.message}")
except TimeoutError:
    print("Sáraíodh an t-am teorainn: méadaigh an t-am teorainn nó simpligh an t-iarratas")

Éilíonn gach earráid freagairt difriúil, agus má mheascann tú iad, bíonn lúba athiarrachta gan úsáid mar thoradh air, nó, níos measa fós, giniúintí a íocadh as nach dtugann aon toradh.

EarráidCúisGníomh molta
VideoGenerationErrorTeip a chuir an API in iúl: diúltaíodh an leid, foinse neamhbhailí, seirbhís ró-ualaithe… (code, message)Léigh an cód: deisigh an t-iarratas, nó déan iarracht arís níos déanaí mura raibh an tseirbhís ar fáil
TimeoutErrorSáraíodh an t-am fanachta ar thaobh an chliaintMéadaigh an timeout nó laghdaigh an fad
RuntimeErrorD’éag iarratas moillithe, nó críochnaigh sé gan toradhTosaigh an ghiniúint arís
grpc.RpcErrorEarráid iompair SDK, lena n-áirítear teorainneacha ráta (cód RESOURCE_EXHAUSTED) agus fadhbanna eochrachaScar iarratais le cúltaca, nó seiceáil an eochair

Úsáideann an SDK gRPC: ní fheictear teorainn ráta sáraithe mar chód HTTP 429 anseo, ach mar grpc.RpcError leis an gcód RESOURCE_EXHAUSTED.

Eagarthóireacht agus síneadh, an éascaíocht chéanna

Níl aon mhodh tiomnaithe ag baint le heagarthóireacht: is é generate é le físeán foinse, a ritear mar video_url (físeán suas le 8.7 soicind, an fad aschuir céanna, 720p ar a mhéad).

video = client.video.generate(
    prompt="Tiontaigh an radharc go stíl anime Seapánach",
    model="grok-imagine-video",
    video_url="https://example.com/video.mp4",
)

Síneann an fheidhm síneadh seicheamh 2 go 15 soicind le mír 2 go 10 soicind, agus filleann sé an físeán iomlán:

video = client.video.extend(
    prompt="Lean an radharc le panú go dtí an deis",
    model="grok-imagine-video",
    video_url="https://example.com/video.mp4",
    duration=5,
)

Tabhair faoi deara an difríocht leis an API REST: glacann an SDK leis an bhfíseán mar pharaiméadar video_url, cé go bhfuil súil ag an gcorp JSON le hoibiacht video lena hairí url.

Ná fág físeán riamh sa scamall

Ní athraíonn an SDK aon rud faoi nádúr sealadach URLanna torthaí. Má thaispeánann do chód video.url amháin, d’íoc tú as giniúint a bheidh imithe go luath. Is é an dea-chleachtas ná an ghiniúint agus an íoslódáil a chumasc sa fheidhm chéanna, ionas nach féidir an céim a dhearmad.

from pathlib import Path

import httpx


async def generate_and_save(client, prompt, output_file, **options):
    """Gineann sé físeán agus sábhálann sé go háitiúil é (cliant: xai_sdk.AsyncClient)."""
    video = await client.video.generate(
        prompt=prompt,
        model="grok-imagine-video-1.5",
        **options,
    )

    # Íoslódáil láithreach
    async with httpx.AsyncClient() as http:
        response = await http.get(video.url)
        response.raise_for_status()
        Path(output_file).write_bytes(response.content)

    print(f"Físeán sábhálta: {output_file}")
    return output_file

Chun stóráil a dhéanamh gan dul tríd do fhreastalaí, cuireann an paraiméadar storage_options giniúna an físeán san API Comhad xAI, le dul in éag de do rogha.

Giniúint ilfhíseáin ag an am céanna

Leis an gcliant asioncronach, is coraitín gach glao, agus seolann asyncio.gather baisc iomlán i gcomhthreomhar. Tá an rogha return_exceptions=True cinntitheach anseo: gan é, theipfeadh ar iarratas diúltaithe amháin ar an mbaisc iomlán agus chaillfeá na torthaí a fuarthas cheana féin.

import asyncio
import os

import xai_sdk


async def parallel_generation(requests):
    """Gineann sé ilfhíseáin i gcomhthreomhar."""
    client = xai_sdk.AsyncClient(api_key=os.getenv("XAI_API_KEY"))
    tasks = [
        client.video.generate(
            prompt=req["prompt"],
            model="grok-imagine-video-1.5",
            duration=req.get("duration", 5),
            aspect_ratio=req.get("aspect_ratio", "16:9"),
        )
        for req in requests
    ]

    results = await asyncio.gather(*tasks, return_exceptions=True)

    for i, res in enumerate(results, 1):
        if isinstance(res, Exception):
            print(f"Theip ar Iarratas {i}: {res}")
        else:
            print(f"Críochnaíodh Iarratas {i}: {res.url}")

    return results

Tá dhá ráthán ag fráma an chomhthreomharaithe seo. Caitheann iarratais do theorainn ráta, a áirítear in iarratais in aghaidh an tsoicind de réir leibhéal do fhoirne (10 ag an leibhéal iontrála do mhúnlaí físeáin): le haghaidh baisc mhóir, ceangail comhthreomhaireacht le asyncio.Semaphore. Cuimhnigh freisin ar an méid a dhéanann comhthreomhaireacht agus nach ndéanann: ní luathaíonn sí aon ghiniúint aonair, ní laghdaíonn sí ach an t-am baisc iomlán.

Ar chóir duit pollú láimhe a thréigean?

Ní go córasach. Taispeánann an comparáid seo a leanas cá bhfaigheann gach cur chuige an lámh in uachtar.

GnéPollú láimheSDK
CastachtArdÍseal
Láimhseáil earráidíLe cur i bhfeidhmComhtháite
Am teorainnLe cur i bhfeidhm10 nóiméad réamhshocraithe, inchoigeartaithe
Eatramh pollaitheLe roghnú1 s réamhshocraithe, inchoigeartaithe
SolúbthachtIomlánCaighdeánach (nó start agus get)
SpleáchasGan aon cheannxAI SDK

Coinníonn pollú láimhe a ábharthacht i dhá chás: nuair a theastaíonn smacht mín uait, mar shampla chun dul chun cinn a chur ar aghaidh chuig comhéadan fíor-ama nó chun é a chomhtháthú i gcóras ciú atá ann cheana, agus nuair a chuireann do chomhthéacs imlonnaithe cosc ar spleáchas breise a chur leis.

Príomhphointí

  • Seolann client.video.generate, fanann sé, agus filleann sé an físeán (url, duration, model); am teorainn 10 nóiméad agus seiceáil soicind amháin de réir réamhshocraithe
  • Úsáideann eagarthóireacht generate le video_url, úsáideann síneadh client.video.extend
  • Déanann VideoGenerationError (ó xai_sdk.video), TimeoutError, agus RuntimeError idirdhealú ar theipeanna; tagann teorainneacha ráta mar grpc.RpcError
  • Íoslódáil an físeán láithreach i gcónaí tar éis giniúna (URLanna sealadacha)
  • Déanann an cliant asioncronach agus asyncio.gather paraiméadrú ar bhaisc, laistigh de theorainn ráta do leibhéil