Combinarea editării și extinderii
Pe această pagină
Actualizat pe 2 noiembrie 2026. Conform referinței API video xAI: imaginea sursă se introduce într-un obiect
image, iar videoclipul de editat sau extins într-un obiectvideo({"url": ...}), atât pentru extindere, cât și pentru editare. Surse: Extinderea videoclipurilor · Referință videoclipuri.
Fluxuri de producție avansate
Folosite izolat, fiecare endpoint are limite: generarea se oprește la 15 secunde, editarea la 8,7 secunde de sursă, iar extinderea la 10 secunde adăugate. Combinate, acestea formează fluxuri de producție care depășesc cu mult aceste limite și, esențial, vă oferă un punct de control după fiecare segment. Această lecție acoperă trei fluxuri din lumea reală, de la clipuri de produs la variații stilistice, și modul în care le puteți face fiabile.
Fluxul 1: Un promo de 15 secunde pentru un produs
Scenariul este clasic: aveți o fotografie cu un smartphone și trebuie să livrați un video promoțional de 15 secunde. Fluxul se construiește în trei segmente de câte 5 secunde, fiecare fiind validat înainte de a trece la următorul.
Primul segment animează fotografia produsului—rotație, joc de reflexii—prin tehnologia imagine-video studiată în secțiunea anterioară.
{
"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"
}
Al doilea segment extinde această imagine printr-o extindere care apropie camera de ecran, reinjectând URL-ul obținut în pasul anterior.
{
"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
}
Al treilea segment încheie secvența cu un plan larg, pornind de data aceasta de la ieșirea celui de-al doilea 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
}
Cincisprezece secunde de conținut nou, la 0,05 USD pe secundă cu grok-imagine-video: așteptați-vă la aproximativ 0,75 USD, exclusiv iterările, dacă fiecare segment este facturat în funcție de durata sa. Costul real al fiecărui pas apare în câmpul usage.cost_in_usd_ticks din rezultatul său: verificați acest aspect pe un flux de test înainte de a bugeta o serie.
Fluxul 2: Cinci conținuturi, un singur stil
Situație diferită, logică diferită: trebuie să produceți cinci videoclipuri de câte 5 secunde pentru o campanie socială, cu un stil vizual coerent. Aici, înlănțuirea nu structurează munca; imaginile de referință o fac, fiind identice pentru toate generările. Cele cinci prompturi descriu scene diferite; stilul rămâne constant datorită acelorași două elemente vizuale.
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"
}
)
Cinci clipuri de câte 5 secunde ajung la 1,25 USD. Observați formatul 9:16 aplicat tuturor cererilor: pentru o campanie verticală, acesta este genul de scăpare care costă o regenerare completă.
Fluxul 3: Derivarea variantelor dintr-un videoclip
Al treilea scenariu nu înlănțuie nimic: aplică mai multe editări diferite, în paralel, asupra aceluiași videoclip sursă. Obțineți astfel patru versiuni ale aceluiași clip, pentru a le propune în teste A/B sau pentru a le distribui pe platforme cu identități distincte.
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}
}
)
Aceste trei fluxuri utilizează patru endpoint-uri, rezumate mai jos.
| Endpoint | Metodă | Intrare | Ieșire | Durată maximă |
|---|---|---|---|---|
/v1/videos/generations | POST | Prompt + opțiuni | Videoclip nou | 1-15s |
/v1/videos/edits | POST | Videoclip + prompt | Videoclip modificat | Sursă până la 8,7s |
/v1/videos/extensions | POST | Videoclip + prompt | Videoclip extins | +2 până la 10s, sursă până la 15s |
/v1/videos/{id} | GET | request_id | Stare + URL | - |
Realizarea unui lanț rezistent la erori
De îndată ce înlănțuiți operațiuni, probabilitatea ca cel puțin una să eșueze devine semnificativă, iar un eșec la al treilea link duce la pierderea primelor două dacă nu ați prevăzut nimic. Funcția următoare încapsulează fiecare pas într-o buclă de reîncercare și avansează la pasul următor doar după obținerea URL-ului.
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
În jurul acestui schelet, cinci obiceiuri fac diferența dintre un prototip și un serviciu. Descărcați rezultatul la fiecare pas, deoarece URL-urile sunt temporare, iar recuperarea după un incident necesită deținerea versiunilor intermediare. Validați vizual fiecare segment înainte de a trece la următorul; altfel, plătiți pentru trei generări doar pentru a descoperi că prima nu a fost adecvată. Gestionați erorile cu încercări spațiate prin „exponential backoff“. Calculați bugetul complet înainte de a lansa un lanț lung, numărând iterările probabile. Și paralelizați ceea ce puteți: în fluxul 2 și fluxul 3, nicio generare nu depinde de alta, așa că pot rula simultan.
Prețuri verificate pe 3 noiembrie 2026 — prețurile se schimbă regulat: înainte de orice calcul bugetar, verificați tarifele curente pe pagina oficială xAI pentru modele și prețuri.
Puncte cheie
- Cele trei endpoint-uri (generare, editare, extindere) se combină în fluxuri
- Imaginile de referință asigură coerența stilistică între mai multe videoclipuri
- Editarea iterativă permite derivarea unui videoclip în mai multe versiuni
- Descărcați rezultatele intermediare și gestionați erorile la fiecare pas
- Calculați bugetul total înainte de a lansa fluxuri complexe