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

Bainistiú Earráidí agus Imscaradh Táirgeachta

Ceacht 12 as 12 Nuashonraithe 3 Samhain 2026 Meánleibhéal
Ar an leathanach seo
  1. Ullmhaigh d’Fheidhmchlár don Táirgeadh
  2. Dhá Chlann Earráidí, Dhá Am
  3. Déan Athiarracht go Cliste
  4. Scuaine chun Coimeád ar an Rith
  5. Fíoraigh d’Eochair Sula mBraitheann tú Uirthi
  6. Féach Cad a Tharlaíonn sa Táirgeadh
  7. Príomhphointí
  8. Tástáil do Chuid Eolais

Nuashonraithe 2 Samhain, 2026 bunaithe ar dhoiciméadú físeáin xAI agus cód xai-sdk 1.21.0: client.video.generate (seachas client.videos), toradh in url, tuairiscítear teipeanna trí VideoGenerationError le cód (invalid_argument, service_unavailable…), faightear teorainn ráta mar grpc.RpcError le cód RESOURCE_EXHAUSTED — níl an aicme RateLimitError ná an stádas expired ann. 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 HTTPCúisRéiteach
400Paraiméadair neamhbhailí (mar shampla, guth anaithnid in reference_audios)Deisigh an t-iarratas
401Eochair API neamhbhailí nó as dátaFíoraigh an fíordheimhniú
429Sáraíodh an teorainn ráta (iarratais in aghaidh an tsoicind, ag brath ar an leibhéal)Cuir cúltaca (backoff) i bhfeidhm
500Earrá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ádasCúis DhóchúilGníomh
failed + invalid_argument nó permission_deniedDiúltaíodh an t-iarratas nó an t-ábharAthraigh an leid nó an fhoinse
failed + service_unavailable nó internal_errorSeirbhís ró-ualaithe, teagmhasDé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.