Laajenna videota päätepisteellä /v1/videos/extensions
Tällä sivulla
Tunti päivitetty 2. marraskuuta 2026 xAI Video API -viitteiden perusteella: laajennus vastaanottaa videon
video-objektissa ({"url": ...}), aivan kuten muokkauskin – aiempi teksti väitti päinvastaista – tulos luetaan kohdastavideo.url, ja lähde on rajoitettu 15 sekuntiin. Lähteet: Video Extension · Video Reference.
Olemassa olevan videon laajentaminen
Kun muokkaus muuttaa sekvenssiä muuttamatta sen pituutta, laajennus tekee täysin päinvastoin: se pidentää videota luomalla jatko-osan, joka on yhdenmukainen aiemman sisällön kanssa. Tämä ratkaisee videontuotannon yleisimmän ongelman: onnistuneen klipin, joka on liian lyhyt, tai kohtauksen, joka ansaitsee kehittyä alkuperäistä kestoaan pidemmälle. Sen sijaan, että generoisit kaiken uudelleen toivoen samaa ulkoasua, lähdet liikkeelle olemassa olevasta ja jatkat siitä.
POST /v1/videos/extensions -päätepiste
Pyyntö muistuttaa generointipyyntöä, mutta siihen lisätään aloitusvideo.
{
"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
}
Kenttä model pysyy arvona grok-imagine-video, prompt kuvaa, mitä jatkossa pitäisi tapahtua, video-objekti määrittää laajennettavan videon (joko url tai ladatun tiedoston file_id, lähteen ollessa 2–15 sekuntia), ja duration asettaa laajennuksen pituudeksi 2–10 sekuntia – oletusarvo on 6 sekuntia. Toisin kuin muokkauksessa, saat tässä hallinnan takaisin kestoon. Palautettu video sisältää alkuperäisen osuuden ja sen perään liitetyn laajennuksen: 10 sekunnin lähde, jota on jatkettu 5 sekunnilla, tuottaa 15 sekunnin videon.
Seuraava taulukko tiivistää eroja näiden kahden päätepisteen välillä, sillä sekaannukset ovat yleisiä.
| Näkökulma | Muokkaus (/edits) | Laajennus (/extensions) |
|---|---|---|
| Tavoite | Muokkaa sisältöä | Lisää kestoa |
| Videoparametri | video-objekti (url tai file_id) | video-objekti (url tai file_id) |
| Lähteen kesto | Enintään 8,7 s | 2–15 s |
| Tulosteen kesto | Sama kuin lähteellä (Enintään 720p) | Lähde + 2–10 s |
| Alkuperäinen sisältö | Muuttaa | Säilyttää |
Molemmat REST API -päätepisteet vastaanottavat videon samalla tavalla video-objektissa, jossa on url-ominaisuus. Python SDK kuitenkin ottaa sen vastaan video_url-parametrina: älä kopioi tätä parametrinimeä JSON-runkoon, sillä API ei tunnista sitä. Se, mikä todella erottaa nämä kaksi päätepistettä toisistaan, on kesto.
Kolme tapaa jatkaa kohtausta
Yksinkertaisin tapaus on antaa nykyisen toiminnan jatkua sellaisenaan. Kehote poimii meneillään olevan actionin ja pidentää sitä ilman katkoa.
{
"model": "grok-imagine-video",
"prompt": "The character continues walking along the beach, waves rolling gently",
"video": {"url": "https://exemple.com/promenade.mp4"},
"duration": 6
}
Voit myös tuoda muutoksen, eli lisätä uuden elementin tai muuttaa katselusuuntaa. Tämä antaa sekvenssille narratiivista etenemistä.
{
"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 käyttötapaus on lopetus: lyhyt laajennus, joka päättää sekvenssin siististi, usein himmenemisellä.
{
"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
}
Laajennusten ketjutus sekvenssin rakentamiseksi
Mikään ei estä videon laajentamista useita kertoja peräkkäin. Jokainen laajennus tuottaa uuden videon, jonka URL-osoitetta voidaan käyttää lähteenä seuraavalle laajennukselle. Näin voit rakentaa pitkän sekvenssin peräkkäisistä segmenteistä, joita kutakin ohjaa oma kehote. Alla oleva skripti ketjuttaa kolme laajennusta syöttämällä saadun URL-osoitteen takaisin jokaisessa vaiheessa.
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}")
Tällä eleganssilla on hintansa, kirjaimellisesti ja kuvaannollisesti. Jokainen laajennus laskutetaan erikseen. Lähde ei saa ylittää 15 sekuntia, mikä rajoittaa ketjua: jos aloitat 5 sekunnista, sekvenssi saavuttaa 20 sekuntia kolmen 5 sekunnin laajennuksen jälkeen, ja neljäs hylättäisiin. Visuaalinen johdonmukaisuus heikkenee linkkien edetessä, sillä jokainen vaihe luottaa jo tulkittuun tulokseen: yli kolmen tai neljän ketjutetun laajennuksen jälkeen värien ja muotojen drifti muuttuu havaittavaksi. Ja kuten kaikkialla tässä API:ssa, URL-osoitteet ovat väliaikaisia – lataa jokainen väliversio, muuten ketjun lopussa tapahtuva virhe pakottaa sinut aloittamaan alusta.
Generoinnin ja laajennuksen duo
Yleisin tuotantokäytäntö yhdistää molemmat päätepisteet. Generoi ensin lyhyt, 3 sekunnin pohja erittäin tarkalla kehotteella käyttämällä päätepistettä POST /v1/videos/generations. Tämä mahdollistaa aloitusestetiikan iteroinnin pienemmillä kustannuksilla. Lisää sen jälkeen 5 sekuntia kehitystä kutsumalla POST /v1/videos/extensions ja lopuksi 4 sekuntia päätöstä kutsumalla samaa päätepistettä uudelleen. Tuloksena on 12 sekunnin video, joka on rakennettu osa kerrallaan siten, että jokainen osa on validoitu ennen seuraavan aloittamista – kontrolli, jota mikään yksittäinen 12 sekunnin generointi ei tarjoaisi.
Keskeiset asiat
- Laajennus pidentää 2–15 sekunnin videota 2–10 sekunnin segmentillä (oletus 6) ja palauttaa koko videon
- Lähdevideo syötetään
video-objektissa (urltaifile_id), aivan kuten muokkauksessakin; Python SDK käyttää parametriavideo_url - Ketjutus mahdollistaa pitkien sekvenssien luomisen askel askeleelta
- Johdonmukaisuus heikkenee yli 3–4 peräkkäisen laajennuksen jälkeen
- Yhdistä alkuperäinen generointi ja laajennukset saadaksesi tarkan sisällönhallinnan