Bainistiú Earráidí agus Imscaradh Táirgeachta
Ar an leathanach seo
Nuashonraithe 2 Samhain, 2026 bunaithe ar dhoiciméadú físeáin xAI agus cód
xai-sdk1.21.0:client.video.generate(seachasclient.videos), toradh inurl, tuairiscítear teipeanna tríVideoGenerationErrorle cód (invalid_argument,service_unavailable…), faightear teorainn ráta margrpc.RpcErrorle códRESOURCE_EXHAUSTED— níl an aicmeRateLimitErrorná an stádasexpiredann. Forlíonadh 3 Samhain, 2026: déanann an teorainn ráta comhaireamh ar iarratais in aghaidh an tsoicind (10 ag an gcéad leibhéal), seachas “60 RPM”, agus léitear an costas iarbhír in aghaidh na giniúna óusage.cost_in_usd_ticks. Foinse: Giniúint Físeáin · Teorainneacha Ráta.
Ullmhaigh d’Fheidhmchlár don Táirgeadh
Níl mórán i gcoiteann ag scipt a ghineann físeán ar do mheaisín agus seirbhís a tháirgeann na céadta in aghaidh an lae d’úsáideoirí fíor. Caithfidh an ceann deireanach diúltuithe measúnaithe, sáruithe cuóta, teagmhais freastalaí, agus URLanna atá ag dul in éag a láimhseáil gan giniúint íoctha a chailleadh go ciúin riamh. Clúdaíonn an ceacht seo na sásraí a dhéanann an difríocht: aicmiú earráidí, straitéis athiarrachta, ailtireacht scuaine, agus inbhreathnaitheacht.
Dhá Chlann Earráidí, Dhá Am
Tagann an chéad chlann chun solais láithreach, ag am an ghla POST. Is earráidí iarratais docht iad seo, agus is leor an cód HTTP chun cinneadh a dhéanamh faoin méid atá le déanamh.
| Cód HTTP | Cúis | Réiteach |
|---|---|---|
| 400 | Paraiméadair neamhbhailí (mar shampla, guth anaithnid in reference_audios) | Deisigh an t-iarratas |
| 401 | Eochair API neamhbhailí nó as dáta | Fíoraigh an fíordheimhniú |
| 429 | Sáraíodh an teorainn ráta (iarratais in aghaidh an tsoicind, ag brath ar an leibhéal) | Cuir cúltaca (backoff) i bhfeidhm |
| 500 | Earráid freastalaí | Déan athiarracht le cúltaca easpónantúil |
Léiríonn an dara clann i bhfad níos déanaí, le linn polaithe, tar éis glacadh leis an iarratas agus tosú na giniúna.
| Stádas | Cúis Dhóchúil | Gníomh |
|---|---|---|
failed + invalid_argument nó permission_denied | Diúltaíodh an t-iarratas nó an t-ábhar | Athraigh an leid nó an fhoinse |
failed + service_unavailable nó internal_error | Seirbhís ró-ualaithe, teagmhas | Déan athiarracht níos déanaí |
Níl an t-idirdhealú seo acadúil: caithfidh 400 filleadh láithreach ar an nglaoir toisc go bhfuil an locht sa chód, ach tarlaíonn stádas failed tar éis roinnt nóiméad feithimh agus ní mór é a láimhseáil i gcomhthéacs an phoist, seachas san iarratas HTTP a spreag é.
Déan Athiarracht go Cliste
Is é an bonn coiteann ná cúltaca easpónantúil le beagán giotaire (jitter). Tugann an t-am a dhúbailt seans do theagmhas sealadach réiteach, agus coscaíonn an giotar do phróisis go léir ó bheith ag iarraidh ag an am céanna tar éis buaicphointe — feiniméan a thiontaíonn micr-theip ina teip mharthanach.
import asyncio
import random
async def call_with_retry(func, max_retries=3, base_delay=2):
"""Executes a function with retry and exponential backoff."""
for attempt in range(max_retries + 1):
try:
return await func()
except Exception as e:
if attempt == max_retries:
raise
# Exponential backoff with jitter
delay = base_delay * (2 ** attempt) + random.uniform(0, 1)
print(f"Attempt {attempt + 1} failed: {e}. Retrying in {delay:.1f}s")
await asyncio.sleep(delay)
Níl an scéim ghinearálta seo leor, áfach, toisc nach dtuilleann gach earráid an foighne chéanna. Réiteofar sárú cuóta trí fheitheamh nóiméad iomlán; ní réiteofar diúltú measúnaithe riamh, agus is ionann athiarracht agus íoc as an teip chéanna faoi dhó. Déanann an fheidhm seo idirdhealú idir na cásanna.
import asyncio
from datetime import timedelta
import grpc
from xai_sdk.video import VideoGenerationError
# Failure codes that a retry will not fix
REQUIRES_FIX = {"invalid_argument", "permission_denied", "failed_precondition"}
async def generate_with_retry(client, params, max_retries=3):
"""Video generation with targeted retry (client: xai_sdk.AsyncClient)."""
for attempt in range(max_retries + 1):
is_last = attempt == max_retries
try:
return await client.video.generate(**params)
except VideoGenerationError as e:
if e.code.lower() in REQUIRES_FIX or is_last:
raise # request or content refused: fix before relaunching
await asyncio.sleep(5 * (attempt + 1)) # service overloaded, incident
except grpc.RpcError as e:
if e.code() != grpc.StatusCode.RESOURCE_EXHAUSTED or is_last:
raise
await asyncio.sleep(2 ** attempt) # rate limit: backoff
except TimeoutError:
if is_last:
raise
# Allow more time for the next attempt
params["timeout"] = params.get("timeout", timedelta(minutes=10)) + timedelta(minutes=2)
Scuaine chun Coimeád ar an Rith
Chomh luath agus a fhaigheann do sheirbhís iarratais ó úsáideoirí iolracha, caithfidh tú glacadh leis an iarratas a dhícheangal ón gcur i gcrích, agus thar aon rud eile, comhthreomhaireacht a theorannú chun fanacht faoi theorainn ráta do leibhéil. Comhlíonann scuaine péireáilte le seimeafar an dá riachtanas seo: carnann poist go saor, ach ní fhorghníomhaítear ach deich ar a mhéad ag an am.
import asyncio
from collections import deque
class VideoGenerationQueue:
def __init__(self, client, max_concurrent=10):
self.client = client
self.queue = deque()
self.semaphore = asyncio.Semaphore(max_concurrent)
self.results = {}
async def add(self, job_id, params):
"""Adds a generation to the queue."""
self.queue.append((job_id, params))
async def process(self):
"""Processes all pending generations."""
tasks = []
while self.queue:
job_id, params = self.queue.popleft()
task = asyncio.create_task(
self._execute(job_id, params)
)
tasks.append(task)
await asyncio.gather(*tasks, return_exceptions=True)
async def _execute(self, job_id, params):
"""Executes a generation with concurrency control."""
async with self.semaphore:
try:
result = await generate_with_retry(
self.client, params
)
self.results[job_id] = {
"status": "done",
"url": result.url
}
except Exception as e:
self.results[job_id] = {
"status": "failed",
"error": str(e)
}
Tabhair faoi deara go gcoinníonn gach post a thoradh féin in results, cibé an rath nó teip é: is teagmhas é giniúint a imíonn gan rian nach féidir le duine ar bith a dhiagnóisiú.
Baineann an dara frithghníomh ailtireachta le stóráil. Ós rud é go bhfuil URLanna físeáin sealadach, caithfidh an íoslódáil a bheith uathoibríoch agus láithreach, le hainmniú stampáilte ama a ráthaíonn nach mbíonn aon imbhuailt idir dhá ghiniúint chomhuaineacha.
import httpx
from pathlib import Path
from datetime import datetime
async def save_video(video_url, output_dir="./videos"):
"""Downloads and saves a generated video."""
Path(output_dir).mkdir(parents=True, exist_ok=True)
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
file_path = f"{output_dir}/video_{timestamp}.mp4"
async with httpx.AsyncClient() as client:
resp = await client.get(video_url)
resp.raise_for_status()
Path(file_path).write_bytes(resp.content)
return file_path
Fíoraigh d’Eochair Sula mBraitheann tú Uirthi
Cuirfidh an críochphointe GET /v1/api-key ar an eolas tú faoi stádas do eochrach. Seachnaíonn gla air ag tús na seirbhíse teacht ar eochair bhlocáilte tar éis fiche iarratas teipthe, agus d’úsáideoirí ag feitheamh.
resp = httpx.get(
"https://api.x.ai/v1/api-key",
headers={"Authorization": f"Bearer {api_key}"}
).json()
if resp.get("api_key_blocked") or resp.get("api_key_disabled") or resp.get("team_blocked"):
raise RuntimeError("API key or team blocked, or key disabled")
Féach Cad a Tharlaíonn sa Táirgeadh
Is leor cúig tháscaire chun seirbhís giniúna físeáin a stiúradh. Tomhaiseann an ráta ratha, is é sin le rá an chuid de ghiniúintí a chríochnaíonn mar done, an tsláinte ghinearálta. Feidhmíonn an t-am giniúna meánach, arna thomhas idir an cur isteach agus an stádas done, chun do theorainneacha ama a chalabrú agus d’úsáideoirí a chur ar an eolas. Inis an ráta earráide de réir cineáil — failed de réir chóid earráide, am teorann, teorainn ráta — duit cá háit ar chóir díriú: léiríonn ardú in amanna teorann gan ardú in failed giniúintí atá níos moille ná do spriocdháta feithimh, mar shampla, seachas teipeanna. Caithfear faireachán laethúil a dhéanamh ar an gcostas carnach, faighte trí réimse usage.cost_in_usd_ticks a shuimiú ó gach toradh (is ionann dollar amháin agus 10 billiún tic), nó go malartach trí fhadanna ginte a iolrú faoi phraghas an mhúnla in aghaidh an tsoicind. Ar deireadh, tuarann úsáid cuóta, in iarratais in aghaidh an tsoicind i gcoibhneas le do theorainn leibhéil (10 ag an gcéad leibhéal do mhúnlaí físeáin), sáithiú sula dtiontaítear ina 429 é.
Tógann na méadrachtaí seo go nádúrtha ó logáil struchtúrtha, áit a bhfágann gach giniúint líne inúsáidte ag d’uirlis anailíse.
import logging
import json
logger = logging.getLogger("video-generation")
def log_generation(request_id, status, duration_s, cost, time_ms):
logger.info(json.dumps({
"event": "video_generation",
"request_id": request_id,
"status": status,
"duration_seconds": duration_s,
"cost_usd": cost,
"processing_time_ms": time_ms
}))
Sula osclaíonn tú do sheirbhís don phobal, déan athbhreithniú ar an rud ar fad ón tús. Caithfidh athiarracht le cúltaca easpónantúil agus giotar a bheith i bhfeidhm, agus caithfidh comhthreomhaireacht a bheith teoranta ag seimeafar chun fanacht faoin teorainn ráta. Caithfidh íoslódálacha físeáin tosú go huathoibríoch chomh luath agus a bheidh siad réidh, gan brath ar ghníomh daonna. Caithfidh gach giniúint líne loga a fhágáil ina bhfuil a request_id, a stádas, agus a costas, murach sin beidh an ráta earráide agus an t-am giniúna meánach dofíoraithe. Seiceáil stádas na heochrach API ag am tosaithe seachas ag an gcéad teip. Agus socraigh buiséad le foláirimh sáraithe: ag $0.05 in aghaidh an tsoicind, ídíonn lúb athiarrachta gan teorainn níos tapúla ná mar a shílfeá.
Praghsáil fíoraithe 3 Samhain, 2026 — athraíonn praghsanna go rialta: roimh aon ríomh buiséid, fíoraigh an greille reatha ar an leathanach oifigiúil múnlaí agus praghsanna xAI.
Príomhphointí
- Roinntear earráidí ina siocrónacha (iarratas) agus ina n-asioncrónacha (giniúint)
- Ní thuilleann gach earráid athiarracht: tá measúnú cinntitheach
- Úsáid seimeafar chun giniúintí comhthreomhara a theorannú
- Éilíonn URLanna sealadacha íoslódáil láithreach agus chórasach
- Rianaigh méadrachtaí costais, ratha, agus ama giniúna chun do sheirbhís a stiúradh
Tástáil do Chuid Eolais
Físeán gineálach sa táirgeadh: bailíochtaigh an sreabhadh oibre iomlán.
1. Cad iad saintréithe leide físeáin?
Freagra: Déan cur síos ar an ngníomh agus ar an ngluaiseacht, ní hamháin ar an radharc: ábhar, díláithriú, atmaisféar, fráma — is é an toise ama a dhéanann idirdhealú idir leid físeáin agus leid íomhá.
2. Cad a cheadaíonn íomhá-go-físeán?
Freagra: Beochan íomhá atá ann cheana, nó daoine agus táirgí ar leith a thabhairt isteach i radharc nua ag baint úsáide as íomhánna tagartha — agus, ar grok-imagine-video-1.5, pináil an chéad, an last, nó na príomhíomhánna: éiríonn d’aitheantas amhairc mar phointe tosaigh, ní mar eachtra seans.
3. Eagarthóireacht agus síneadh: cad iad na húsáidí?
Freagra: Athraíonn /videos/edits físeán ginte, fadaíonn /videos/extensions é — agus comhcheanglaítear an dá cheann chun seichimh fhada a thógáil trí athrá.
4. Cén fáth a bhfuil an sreabhadh oibre asioncronach?
Freagra: Tógann giniúint físeáin am: cuirimid post isteach, déanaimid polaithe ar a stádas, agus ansin faighimid an toradh — uathoibríonn an xAI SDK an pholaithe seo.
5. Cad atá le pleanáil don táirgeadh?
Freagra: Bainistiú earráidí agus post teipthe, íoslódáil láithreach aschur, agus rianú costais (taifeach, fad, athrá) — is é físeán an modh is costasaí: caithfear buiséad a dhéanamh dó.
Leid ama, tagairt amhairc, asioncronacht máistrithe: éiríonn físeán gineálach ina phíblíne — ní crannchur.