Muokkausvideot päätepisteellä /v1/videos/edits
Tällä sivulla
Päivitetty 3. marraskuuta 2026. Perustuu xAI:n Video Editing -sivuun: lähdevideo on enintään 8,7 sekuntia pitkä, tuloste säilyttää sen keston, kuvasuhteen ja resoluution (enintään 720p), ja jatkaminen käyttää samaa
video-objektia kuin muokkaus. Väite, että muokkaus olisi epäluotettava tiettyjen elementtien osalta, on ristiriidassa xAI:n esimerkkien kanssa, jotka keskittyvät nimenomaan tarkkoihin muokkauksiin. Lähteet: Video Editing · Video Overview.
Olemassa olevan videon muokkaaminen
Generointi on vain osa työtä. xAI:n API tarjoaa myös videonmuokkauspäätepisteen, joka ottaa olemassa olevan jakson ja muokkaa sitä tekstikehotteiden perusteella. Se on videovastaava kuvienmuokkaukselle, mutta formaattirajoitukset ovat tiukemmat. Ennen kuin kirjoitat ensimmäisen pyyntösi, huomioi neljä rajaa, jotka määrittävät, mitä voit lähettää.
POST /v1/videos/edits -päätepiste
Pyyntö yhdistää lähdevideon ja kehotteen, joka kuvaa haluttua muutosta.
{
"model": "grok-imagine-video",
"prompt": "Vaihda tausta auringonlaskuun meren yllä",
"video": {
"url": "https://example.com/original-video.mp4"
}
}
Kolme kenttää riittää: model, joka pysyy arvona grok-imagine-video; prompt, joka sisältää muutoksen kuvauksen; ja video.url, joka osoittaa käsiteltävään MP4-tiedostoon. Huomaa, että video on kääritty video-objektin sisään, joka hyväksyy joko url:n tai ladatun tiedoston file_id:n: jatkamispäätepiste, jota käsittelemme seuraavassa oppitunnissa, noudattaa samaa käytäntöä.
Tekniset rajoitukset ovat täällä tiukemmat kuin generoinnissa. Lähde ei saa ylittää 8,7 sekuntia, ja tuotettu video säilyttää sen keston; Video Generation -sivu mainitsee keston olevan “rajoitettu 8,7 sekuntiin” tarkentamatta pidemmän lähteen käsittelyä: joten lyhennä lähteesi etukäteen. Resoluutio on rajoitettu 720p:hen. Syötetiedoston on oltava MP4 tuetussa koodekissa, kuten H.264, H.265 tai AV1. Sekaannuttavin kohta generoinnista tuleville: sinulla ei ole hallintaa tulosteen kestoon, kuvasuhteeseen tai resoluutioon, sillä ne määräytyvät lähdevideon perusteella. Muokkauspyynnössä ei ole duration, aspect_ratio eikä resolution-kenttää.
Mitä pyytää muokkauksessa
Taustan vaihto on klassinen esimerkki: kohde pysyy, mutta ympäristö muuttuu.
{
"model": "grok-imagine-video",
"prompt": "Korvaa tausta avaruusmaisemalla, jossa on tähtiä ja sumuja. Pidä sama kohde ja sama liike.",
"video": {"url": "https://example.com/video.mp4"}
}
Tyylimuutokset vaikuttavat koko kuvaan ja muuntavat klipin tyyliä muuttamatta sen toimintaa – kätevää saman jakson sovittamiseen eri universumeihin.
{
"model": "grok-imagine-video",
"prompt": "Muunna tämä video japanilaiseen sarjakuvatyyliin eloisilla väreillä",
"video": {"url": "https://example.com/video.mp4"}
}
Elementtien lisääminen rikastuttaa kohtausta kerroksilla, joita ei ollut kuvauksen aikana, yleensä tunnelmaa luovilla.
{
"model": "grok-imagine-video",
"prompt": "Lisää lunta ja huurteinen efekti reunoihin",
"video": {"url": "https://example.com/video.mp4"}
}
Lopuksi valaistuksen muokkaaminen vastaa jakson uudelleen väritystä: samat otokset, mutta radikaalisti erilainen tunnelma.
{
"model": "grok-imagine-video",
"prompt": "Vaihda valaistus yömaisemaan sinisillä ja violeteilla neonvaloilla",
"video": {"url": "https://example.com/video.mp4"}
}
Asynkroninen sykli, identtinen generoinnin kanssa
Muokkaus noudattaa täsmälleen samaa nelivaiheista protokollaa kuin generointi: lähetät pyynnön, saat request_id:n, kysyt tilaa GET /v1/videos/{request_id} säännöllisin väliajoin ja haet muokatun videon, kun tila muuttuu arvoksi done. Pythonissa kaksi ensimmäistä vaihetta hoituvat muutamalla rivillä.
import httpx
# 1. Lähetä muokkauspyyntö
response = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers={"Authorization": f"Bearer {api_key}"},
json={
"model": "grok-imagine-video",
"prompt": "Lisää sateen efekti koko kohtaukseen",
"video": {"url": "https://example.com/source.mp4"}
}
)
request_id = response.json()["request_id"]
# 2. Kysy tilaa (yksinkertaistettu)
status = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers={"Authorization": f"Bearer {api_key}"}
).json()
Määritä, mikä muuttuu ja mikä pysyy
xAI kuvaa mallin toimintaa yhdellä lauseella: grok-imagine-video toteuttaa pyydetyn muutoksen ja pitää kaiken muun mahdollisimman lähellä lähdettä. Sen dokumentaatio johtaa tästä ohjeen: sano myös, mitä täytyy pitää identtisenä. Sen omat esimerkit keskittyvät myös yhden klipin tarkkoihin muokkauksiin – hopeisen kaulaketjun lisääminen, asun vaihtaminen punaiseen, mustan leveälierisen hatun laittaminen hahmon päälle – suoritettuna rinnakkain samalle lähteelle.
{
"model": "grok-imagine-video",
"prompt": "Vaihda naisen takki punaiseksi. Pidä samat kasvot, sama ympäristö, sama rajaus ja sama liike.",
"video": {"url": "https://example.com/video.mp4"}
}
xAI:n kuvakehotteiden opas, joka on kirjoitettu still-kuville, määrittää toimivan järjestyksen: muutos ensin, sitten lause, joka lukitsee staattiset elementit. Muokkaus, joka alkaa sanoilla “pidä kaikki ennallaan”, muuttaa melkein mitään, ja muokkaus, joka kopioi täyden generointikehotteen, keksii kohtauksen uudelleen.
Neljä tapaa välttää useimmat sudenkuopat: pidä lähteesi alle 8,7 sekunnin pituisina tuetussa koodekissa (H.264, H.265 tai AV1); nimeä, mitä täytyy pitää koskemattomana; testaa muutosta lyhyellä klipillä ennen skaalaamista; ja muista, että muokkaus käyttää grok-imagine-video-mallia, jonka hinnoittelutaulukko näyttää yhden hinnan, 0,050 dollaria sekunnilta – kokeilukierros maksaa saman verran kuin generointi.
Keskeiset asiat
POST /v1/videos/edits-päätepiste muokkaa olemassa olevaa videota kehotteen perusteella käyttäen vaingrok-imagine-video-mallia- Lähde kestää enintään 8,7 sekuntia; tuloste säilyttää sen keston, suhteen ja resoluution (enintään 720p)
- Lähdevideon on oltava MP4 tuetussa koodekissa (H.264, H.265, AV1)
- Pyynnössä ei ole
duration,aspect_ratioeikäresolution-kenttää - Sano, mitä täytyy muuttaa, ja sen jälkeen, mitä täytyy pitää identtisenä