xAI SDK agus Pollú Uathoibríoch
Ar an leathanach seo
Nuashonraithe an 2 Samhain, 2026 bunaithe ar dhoiciméadú físeáin xAI agus ar chód
xai-sdk1.21.0: is iadclient.video.generateagusclient.video.extendna modhanna (úsáideann eagarthóireachtgeneratelevideo_url, nochtann an toradhurl, socraítear an mhoill trítimedelta, agus is é an t-eatramh pollaithe réamhshocraithe ná soicind amháin. Éilíonnawaitan cliant asioncronachAsyncClient, agus allmhairítear an eisceachtVideoGenerationErroró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áid | Cúis | Gníomh molta |
|---|---|---|
VideoGenerationError | Teip 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 |
TimeoutError | Sáraíodh an t-am fanachta ar thaobh an chliaint | Méadaigh an timeout nó laghdaigh an fad |
RuntimeError | D’éag iarratas moillithe, nó críochnaigh sé gan toradh | Tosaigh an ghiniúint arís |
grpc.RpcError | Earráid iompair SDK, lena n-áirítear teorainneacha ráta (cód RESOURCE_EXHAUSTED) agus fadhbanna eochracha | Scar 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áimhe | SDK |
|---|---|---|
| Castacht | Ard | Íseal |
| Láimhseáil earráidí | Le cur i bhfeidhm | Comhtháite |
| Am teorainn | Le cur i bhfeidhm | 10 nóiméad réamhshocraithe, inchoigeartaithe |
| Eatramh pollaithe | Le roghnú | 1 s réamhshocraithe, inchoigeartaithe |
| Solúbthacht | Iomlán | Caighdeánach (nó start agus get) |
| Spleáchas | Gan aon cheann | xAI 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
generatelevideo_url, úsáideann síneadhclient.video.extend - Déanann
VideoGenerationError(óxai_sdk.video),TimeoutError, agusRuntimeErroridirdhealú ar theipeanna; tagann teorainneacha ráta margrpc.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.gatherparaiméadrú ar bhaisc, laistigh de theorainn ráta do leibhéil