Extinderea videoclipurilor cu /v1/videos/extensions
Pe această pagină
Lecție actualizată la 2 noiembrie 2026 pe baza documentației de referință xAI Video API: extinderea primește videoclipul într-un obiect
video({"url": ...}), exact ca în cazul editării—textul anterior susținea contrariul—rezultatul se citește dinvideo.url, iar sursa este limitată la 15 secunde. Surse: Video Extension · Video Reference.
Extinderea unui videoclip existent
În timp ce editarea transformă o secvență fără a-i modifica durata, extinderea face exact opusul: mărește durata unui videoclip prin generarea unei continuări coerente cu ceea ce a precedat. Aceasta rezolvă cea mai frecventă problemă din generarea de videoclipuri: un clip reușit care este prea scurt sau o scenă care merită să se dezvolte dincolo de durata inițială. În loc să regenerați totul sperând să recreați același aspect, porniți de la ceea ce există și continuați.
Punctul final POST /v1/videos/extensions
Solicitarea seamănă cu o cerere de generare, cu adăugarea videoclipului de pornire.
{
"model": "grok-imagine-video",
"prompt": "Continue the scene with a zoom out revealing the full landscape",
"video": {"url": "https://exemple.com/video-courte.mp4"},
"duration": 5
}
Câmpul model rămâne grok-imagine-video, prompt descrie ceea ce ar trebui să se întâmple în continuare, obiectul video specifică videoclipul de extins (un url sau file_id al unui fișier încărcat, pentru o sursă de 2 până la 15 secunde), iar duration stabilește lungimea extinderii între 2 și 10 secunde—valoarea implicită este de 6 secunde. Spre deosebire de editare, aici recâștigați controlul asupra duratei. Videoclipul returnat conține originalul urmat de extindere: o sursă de 10 secunde extinsă cu 5 secunde va produce un videoclip de 15 secunde.
Tabelul următor rezumă diferențele dintre cele două puncte finale, deoarece confuzia este frecventă.
| Aspect | Editare (/edits) | Extindere (/extensions) |
|---|---|---|
| Obiectiv | Modificarea conținutului | Adăugarea de durată |
| Parametru video | Obiect video (url sau file_id) | Obiect video (url sau file_id) |
| Durata sursei | Max 8,7 s | 2 până la 15 s |
| Durata ieșirii | La fel ca sursa (Max 720p) | Sursă + 2 până la 10 s |
| Conținut original | Modifică | Păstrează |
Ambele puncte finale REST API primesc videoclipul în același mod, într-un obiect video cu o proprietate url. Totuși, SDK-ul Python îl preia ca parametru video_url: nu copiați acest nume de parametru într-un corp JSON, deoarece API-ul nu îl va recunoaște. Ceea ce distinge cu adevărat cele două puncte finale este durata.
Trei moduri de a continua o scenă
Cel mai simplu caz constă în a lăsa acțiunea curentă să continue. Promptul preia acțiunea actuală și o extinde fără întrerupere.
{
"model": "grok-imagine-video",
"prompt": "The character continues walking along the beach, waves rolling gently",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
Puteți introduce, de asemenea, o schimbare, adică aducerea unui element nou sau modificarea direcției de vizualizare. Acest lucru oferă secvenței o progresie narativă.
{
"model": "grok-imagine-video",
"prompt": "The camera pivots right revealing a lighthouse in the distance, the lighthouse beam starts to rotate",
"video": {"url": "https://exemple.com/plage.mp4"},
"duration": 8
}
Al treilea caz de utilizare este concluzia: o extindere scurtă care închide secvența curat, adesea cu o estompare (fade).
{
"model": "grok-imagine-video",
"prompt": "The scene ends with a gradual fade to black, the last glimmers of sunlight disappear on the horizon",
"video": {"url": "https://exemple.com/coucher-soleil.mp4"},
"duration": 4
}
Înlănțuirea extinderilor pentru a construi o secvență
Nimic nu vă împiedică să extindeți un videoclip de mai multe ori la rând. Fiecare extindere produce un nou videoclip al cărui URL poate servi drept sursă pentru următoarea extindere, permițându-vă să construiți o secvență lungă prin segmente succesive, fiecare fiind condusă de propriul prompt. Scriptul de mai jos înlănțuie trei extinderi prin reinjectarea URL-ului obținut la fiecare pas.
import httpx
import time
api_key = "your_key"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
def attendre_video(request_id):
"""Poll status until completion."""
while True:
resp = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers=headers
).json()
if resp["status"] == "done":
return resp["video"]["url"]
if resp["status"] == "failed":
raise RuntimeError(f"Generation failed: {resp.get('error')}")
time.sleep(5)
# Base video
video_url = "https://exemple.com/video-initiale.mp4"
# Chain 3 extensions
prompts = [
"The character crosses the bridge, profile view",
"He stops in the middle and looks at the river below",
"He resumes walking toward the other bank, the camera follows"
]
for prompt in prompts:
resp = httpx.post(
"https://api.x.ai/v1/videos/extensions",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": prompt,
"video": {"url": video_url},
"duration": 5
}
).json()
video_url = attendre_video(resp["request_id"])
print(f"Extension complete: {video_url}")
Această eleganță are un preț, la propriu și la figurat. Fiecare extindere este facturată separat. Sursa nu poate depăși 15 secunde, ceea ce limitează lanțul: pornind de la 5 secunde, secvența ajunge la 20 de secunde după trei extinderi de câte 5 secunde, iar o a patra ar fi refuzată. Coerența vizuală se degradează pe parcursul verigilor, deoarece fiecare pas se bazează pe un rezultat deja interpretat: dincolo de trei sau patru extinderi înlănțuite, devin vizibile derivele de culoare și morfologie. Și, ca peste tot în acest API, URL-urile sunt temporare—descărcați fiecare versiune intermediară, altfel o eroare la sfârșitul lanțului vă va obliga să o luați de la capăt.
Duo-ul generare apoi extindere
Modelul cel mai comun în producție combină ambele puncte finale. Mai întâi generați o bază scurtă de 3 secunde cu un prompt foarte precis, prin POST /v1/videos/generations, permițându-vă să iterați asupra esteticii de pornire la un cost mai mic. Apoi adăugați 5 secunde de dezvoltare prin POST /v1/videos/extensions, urmate de 4 secunde de concluzie printr-un al doilea apel către același punct final. Rezultatul este un videoclip de 12 secunde construit segment cu segment, unde fiecare parte a fost validată înainte de a trece la următoarea—un control pe care nicio generare unică de 12 secunde nu l-ar putea oferi.
Puncte cheie
- Extinderea mărește un videoclip de 2 până la 15 secunde cu un segment de 2 până la 10 secunde (implicit 6) și returnează videoclipul complet
- Videoclipul sursă se introduce într-un obiect
video(urlsaufile_id), la fel ca la editare; SDK-ul Python îl preia cavideo_url - Înlănțuirea permite crearea de secvențe lungi pas cu pas
- Coerența se degradează dincolo de 3-4 extinderi succesive
- Combinați generarea inițială cu extinderile pentru un control precis al conținutului