Videolaiendamine liidesepunkti /v1/videos/extensions abil
Sellel lehel
Tund uuendatud 2. novembril 2026 vastavalt xAI Video API dokumentatsioonile: laiendamine saab video kätte
videoobjektina ({"url": ...}), täpselt nagu redigeerimisel – varasem tekst väitis vastupidist – tulemus loetakse väljaltvideo.urlja allikas on piiratud 15 sekundiga. Allikad: Video Extension · Video Reference.
Olemasoleva video laiendamine
Kui redigeerimine muudab järjestust selle pikkust muutmata, siis laiendamine teeb täpselt vastupidist: see pikendab videot, genereerides eelnevaga kooskõlas oleva jätku. See lahendab videote genereerimise levinuima probleemi – edukas klipp on liiga lühike või stseen vääriks arenemist kaugemale algsest kestusest. Kõige uuesti genereerimise ja sama välimuse taastamise lootmise asemel alustad olemasolevast ja jätkad sealt.
POST /v1/videos/extensions liidesepunkt
Päring sarnaneb genereerimispäringuga, millele on lisatud algne video.
{
"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
}
Väli model jääb väärtusele grok-imagine-video, prompt kirjeldab, mida jätkus peaks juhtuma, objekt video määrab laiendatava video (kas url või üles laaditud faili file_id, allika pikkusega 2 kuni 15 sekundit) ning duration määrab laienduse pikkuse vahemikus 2 kuni 10 sekundit – vaikimisi on see 6 sekundit. Erinevalt redigeerimisest saad siin taas kontrolli kestuse üle. Tagastatud video sisaldab algset osa, millele järgneb laiendus: 10-sekundiline allikas, mida on pikendatud 5 sekundi võrra, annab tulemuseks 15-sekundise video.
Järgnev tabel võtab kokku erinevused kahe liidesepunkti vahel, kuna segadus on levinud.
| Aspekt | Redigeerimine (/edits) | Laiendamine (/extensions) |
|---|---|---|
| Eesmärk | Sisu muutmine | Kestuse lisamine |
| Video parameeter | Objekt video (url või file_id) | Objekt video (url või file_id) |
| Allika kestus | Maks 8,7 s | 2 kuni 15 s |
| Väljundi kestus | Sama kui allikal (Maks 720p) | Allikas + 2 kuni 10 s |
| Algne sisu | Muudab | Säilitab |
Mõlemad REST API liidesepunktid saavad video kätte samal viisil: objektis video, millel on omadus url. Pythoni SDK kasutab aga parameetrit video_url: ära kopeeri seda parameetri nime JSON-i kehasse, kuna API ei tunne seda ära. See, mis neid kahte liidesepunkti tegelikult eristab, on kestus.
Kolm viisi stseeni jätkamiseks
Lihtsaim juhtum on lasta toimuval lihtsalt edasi kesta. Prompt jätkab praegust tegevust ilma katkestuseta.
{
"model": "grok-imagine-video",
"prompt": "The character continues walking along the beach, waves rolling gently",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
Saad ka sisse tuua muutuse, tähendades uue elemendi lisamist või vaatenurga muutmist. See annab järjestusele narratiivse arengu.
{
"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
}
Kolmas kasutusjuhtum on lõpetus: lühike laiendus, mis sulgeb järjestuse puhtalt, sageli hajumisefektiga.
{
"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
}
Järjestuse loomine laienduste aheldamise teel
Midagi ei takista videot mitu korda järjest laiendamast. Iga laiendus toodab uue video, mille URL-i saab kasutada järgmise laienduse allikana, võimaldades sul ehitada pikka järjestust järjestikuste segmentidena, mida igaüht juhib oma prompt. Allpool olev skript aheldab kolm laiendust, süstides saadud URL-i igal sammul tagasi.
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}")
Sellel elegantsusel on oma hind, nii sõna otseses kui ka kaudses mõttes. Iga laiendust arveldatakse eraldi. Allikas ei tohi ületada 15 sekundit, mis seab ahelale piiri: alustades 5 sekundist, jõuab järjestus pärast kolme 5-sekundist laiendust 20 sekundini ja neljas lükatakse tagasi. Visuaalne kooskõla halveneb lülide vahel, kuna iga samm tugineb juba tõlgendatud väljundile: pärast kolme või nelja aheldatud laiendust muutuvad nähtavaks värvi ja morfoloogia nihked. Nagu kõikjal selles API-s, on URL-id ajutised – laadi iga vaheversioon alla, vastasel juhul sunnib tõrge ahela lõpus sind algusest peale uuesti alustama.
Genereerimise ja laiendamise duett
Tootmises on levinuim muster mõlema liidesepunkti kombineerimine. Esiteks genereerid väga täpse prompti abil lühikese 3-sekundise baasi kasutades POST /v1/videos/generations, mis võimaldab sul madalama kuluga iteratsioone teha algse esteetika kallal. Seejärel lisad 5 sekundit arengut kasutades POST /v1/videos/extensions ja seejärel 4 sekundit lõpetust sama liidesepunkti teise väljakutsega. Tulemuseks on segmenthaaval ehitatud 12-sekundine video, kus iga osa on enne järgmise alustamist valideeritud – kontrollitase, mida üksainus 12-sekundine genereerimine pakkuda ei suudaks.
Peamised punktid
- Laiendamine pikendab 2–15-sekundist videot 2–10-sekundise segmendiga (vaikimisi 6) ja tagastab tervikliku video
- Allikasvideo asetatakse objekti
video(urlvõifile_id), nagu redigeerimiselgi; Pythoni SDK kasutab seda parameetrinavideo_url - Aheldamine võimaldab luua pikki järjestusi samm-sammult
- Kooskõla halveneb pärast 3–4 järjestikust laiendust
- Kombineeri algne genereerimine ja laiendused sisu täpseks kontrollimiseks