Għaqqad l-editjar u l-estensjoni
F'din il-paġna
Aġġornat fit-2 ta’ Novembru, 2026. Ibbażat fuq ir-referenza tal-API tal-vidjow ta’ xAI: l-immaġni sors tmur f’oġġett
image, u l-vidjow li trid teditja jew testendi jmur f’oġġettvideo({"url": ...}), kemm għall-estensjoni kif ukoll għall-editjar. Sorsi: Video Extension · Videos Reference.
Pipelines avvanzati tal-produzzjoni
Meta tużahom waħedhom, kull endpoint għandu limitazzjonijiet: il-ġenerazzjoni tieqaf f’15-il sekonda, l-editjar f’8.7 sekondi ta’ sors, u l-estensjoni f’10 sekondi miżjuda. Meta tgħaqqadhom, jiffurmaw pipelines tal-produzzjoni li jaqbżu b’mod konsiderevoli dawn il-limiti u, l-aktar importanti, jagħtuk punt ta’ kontroll wara kull segment. Din il-lezzjoni tkopri tliet pipelines reali, minn klips tal-prodotti sa varjazzjonijiet stilistiċi, u kif tagħmilhom affidabbli.
Pipeline 1: Promo tal-prodott ta’ 15-il sekonda
Ix-xenarju huwa klassiku: għandek ritratt ta’ smartphone u trid twassal vidjow promozzjonali ta’ 15-il sekonda. Il-pipeline tinbena f’tliet segmenti ta’ ħames sekondi, kull wieħed ivvalidat qabel ma tibda l-li jmiss.
L-ewwel segment janima r-ritratt tal-prodott—rotazzjoni, logħob tar-riflessjonijiet—permezz tal-immaġni-għal-vidjow li studjajt fis-sezzjoni preċedenti.
{
"model": "grok-imagine-video",
"prompt": "Elegant rotation of the smartphone on a dark background, light reflections on the screen",
"image": {"url": "https://exemple.com/smartphone.jpg"},
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}
It-tieni jestendi din l-isparatura b’estensjoni li tqarreb il-kamera lejn l-iskrin, terġa’ tintroduċi l-URL miksuba fil-pass ta’ qabel.
{
"model": "grok-imagine-video",
"prompt": "Progressive zoom towards the smartphone screen turning on, displaying a colorful interface",
"video": {"url": "{url_video_etape_1}"},
"duration": 5
}
It-tielet jagħlaq is-sekwenza fuq pjan wiesa’, jibda din id-darba mill-output tat-tieni segment.
{
"model": "grok-imagine-video",
"prompt": "Zoom out revealing the smartphone placed on a design desk, soft light, slight background blur",
"video": {"url": "{url_video_etape_2}"},
"duration": 5
}
Ħmistax-il sekonda ta’ kontenut ġdid, bi $0.05 kull sekonda ma’ grok-imagine-video: stenna madwar $0.75 esklużi l-iterazzjonijiet jekk kull segment jiġi fatturat skont id-durata tiegħu. L-ispiża attwali ta’ kull pass tidher fil-qasam usage.cost_in_usd_ticks tar-riżultat tiegħu: ivverifika dan fuq pipeline ta’ test qabel ma tibbaġitja serje.
Pipeline 2: Ħames kontenuti, stil wieħed
Sitwazzjoni differenti, loġika differenti: għandek bżonn tipproduċi ħames vidjows ta’ ħames sekondi għal kampanja soċjali b’stil viżiv konsistenti. Hawnhekk, il-katina ma tistrutturax ix-xogħol; l-immaġnijiet ta’ referenza jagħmlu dan, identiċi għall-ġenerazzjonijiet kollha. Il-ħames prompts jiddeskrivu xeni differenti; l-istil jibqa’ konsistenti grazzi għall-istess żewġ viżwali.
references = [
{"url": "https://exemple.com/style-campagne-1.jpg"},
{"url": "https://exemple.com/style-campagne-2.jpg"}
]
prompts = [
"Coffee pouring into a white ceramic cup, rising steam",
"Hands typing on a keyboard, blurred screen in background",
"An open notebook with a pen writing, natural light",
"A green plant growing in timelapse in a clay pot",
"A book whose pages turn in the wind on a terrace"
]
for prompt in prompts:
resp = httpx.post(
"https://api.x.ai/v1/videos/generations",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": prompt,
"reference_images": references,
"duration": 5,
"aspect_ratio": "9:16",
"resolution": "720p"
}
)
Ħames klips ta’ ħames sekondi jiġu $1.25. Innota l-format 9:16 applikat għat-talbiet kollha: għal kampanja vertikali, dan huwa t-tip ta’ żball li jiswa riġenerazzjoni sħiħa.
Pipeline 3: Derivazzjoni ta’ varjanti minn vidjow
It-tielet skema ma tgħaqqad xejn: tapplika diversi editjar differenti b’mod parallel fuq l-istess vidjow sors. Hekk tikseb erba’ verżjonijiet tal-istess klip, biex toffrihom għal testijiet A/B jew biex tiddistribwixxihom fuq pjattaformi b’identitajiet distinti.
video_source = "https://exemple.com/video-base.mp4"
variations = [
"Cinematic black and white style, film grain",
"Pop art saturated colors, strong contrasts",
"Night ambiance, purple and blue neon lights",
"Watercolor style, soft outlines and washed colors"
]
for variation in variations:
resp = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": variation,
"video": {"url": video_source}
}
)
Dawn it-tliet pipelines jużaw erba’ endpoints, riassunti hawn taħt.
| Endpoint | Metodu | Input | Output | Durata massima |
|---|---|---|---|---|
/v1/videos/generations | POST | Prompt + għażliet | Vidjow ġdid | 1-15s |
/v1/videos/edits | POST | Vidjow + prompt | Vidjow modifikat | Sors sa 8.7s |
/v1/videos/extensions | POST | Vidjow + prompt | Vidjow estiż | +2 sa 10s, sors sa 15s |
/v1/videos/{id} | GET | request_id | Status + URL | - |
Tagħmel katina reżistenti għall-fallimenti
Hekk kif tibda tgħaqqad operazzjonijiet, il-probabbiltà li wieħed mill-inqas ifalli ssir sinifikanti, u falliment fit-tielet rabta jitlifek l-ewwel żewġ jekk ma jkun hemm xejn ippjanat. Il-funzjoni li ġejja tinkapsula kull pass f’loop ta’ riprovazzjoni u tavvanza biss għall-pass li jmiss ladarba tinkiseb l-URL.
async def pipeline_with_retry(steps, max_retries=2):
video_url = None
for i, step in enumerate(steps):
for attempt in range(max_retries + 1):
try:
if step["type"] == "generation":
result = await generate_video(step["params"])
elif step["type"] == "extension":
step["params"]["video"] = {"url": video_url}
result = await extend_video(step["params"])
elif step["type"] == "edition":
step["params"]["video"] = {"url": video_url}
result = await edit_video(step["params"])
video_url = await wait_for_result(result["request_id"])
break
except Exception as e:
if attempt == max_retries:
raise Exception(f"Step {i+1} failed: {e}")
await asyncio.sleep(10)
return video_url
Madwar din l-istruttura, ħames drawwiet jagħmlu d-differenza bejn prototip u servizz. Niżżel ir-riżultat f’kull pass, peress li l-URLs huma temporanji u l-irkupru minn inċident jeħtieġ li jkollok verżjonijiet intermedjarji. Ivvvalida viżwalment kull segment qabel ma tgħaddi għall-li jmiss, inkella tħallas għal tliet ġenerazzjonijiet biss biex issib li l-ewwel waħda ma kinitx xierqa. Immaniġġja l-iżbalji b’tentattivi mifruda b’backoff esponenzjali. Ikkalkula l-baġit sħiħ qabel ma tniedi katina twila, u għodd l-iterazzjonijiet probabbli. U parallellizza dak li tista’: fil-pipeline 2 u l-pipeline 3, l-ebda ġenerazzjoni ma tiddependi fuq oħra, allura jistgħu jiġu esegwiti simultanjament.
Prezzijiet ivverifikati fit-3 ta’ Novembru, 2026 — il-prezzijiet jinbidlu regolarment: qabel kwalunkwe kalkolu tal-baġit, iċċekkja r-rati attwali fuq il-paġna uffiċjali tal-mudelli u l-prezzijiet ta’ xAI.
Punti Ewlenin
- It-tliet endpoints (ġenerazzjoni, editjar, estensjoni) jingħaqdu f’pipelines
- L-immaġnijiet ta’ referenza jiżguraw konsistenza stilistika f’diversi vidjows
- L-editjar iterattiv jippermetti li tidderiva vidjow f’diversi verżjonijiet
- Niżżel ir-riżultati intermedjarji u immaniġġja l-iżbalji f’kull pass
- Ikkalkula l-baġit totali qabel ma tniedi pipelines kumplessi