Referenciaképek és rögzített képek
Ezen az oldalon
A leckét 2026. november 2-án írtuk át az xAI Reference-to-Video dokumentációja alapján: a referenciaképek konkrét személyek, tárgyak vagy ruházati elemek megjelenítését teszik lehetővé, amelyeket a prompt
<IMAGE_0>,<IMAGE_1>… formában jelöl meg – nem csupán stílus átvitelére szolgálnak; agrok-imagine-video-1.5modellen immár társíthatók azimageparaméterrel (rögzített első kép), az utolsó képpel, kulcsképekkel és hangokkal. A korábbi verzió tévesen állította, hogy azimageés areference_imagesparaméterek összeférhetetlenek lennének. Források: Reference-to-Video · Reference Videos.
Vizualitás biztosítása a modell számára
A képek közvetlen animálása nem az egyetlen módja annak, hogy vizuális tartalmat adj a modellnek. Az xAI videó API-ja egy második mechanizmust is kínál: a referenciaképeket. Ezek nem a képet mozdítják meg olyannak, amilyen, hanem olyan elemeket szolgáltatnak, amelyeknek meg kell jelenniük a videóban – egy személy, egy termék, egy ruhadarab –, anélkül, hogy az előteret befagyasztanák. Ebben a leckében az image és a reference_images közötti határvonal megértése a kulcs.
Két paraméter, két szándék
Az image paraméter azt a képet szolgáltatja, amelyet animálni kell: ez lesz a videó első kockája, és annak tartalma kerül mozgásba. Ez az előző leckékben tárgyalt képből-videó (image-to-video) módszer.
A reference_images paraméter olyan képeket biztosít, amelyek elemeit a modell újrahasznosítja: egy modell arca, egy ing, egy parfümösüveg. Maga a jelenet a te promptod szerint alakul. Az xAI három tipikus felhasználási esetet említ: virtuális próbafülke, termékelhelyezés és visszatérő szereplőkkel rendelkező történetek. Minden referencia lehet nyilvános HTTPS URL, base64-kódolt adat vagy egy feltöltött fájl file_id-je, és egyetlen kérésben mindhárom formátum keverhető.
{
"model": "grok-imagine-video-1.5",
"prompt": "Lassú követő felvétel egy fehér kifutón. A <IMAGE_0> modell a háttérből lép elő, és a kamera felé sétál; rajta van a <IMAGE_1> ing és egy fekete farmer. Lassított felvétel, magas minőség, részletes arcok.",
"reference_images": [
{"url": "https://exemple.com/mannequin.jpg"},
{"url": "https://exemple.com/chemise.jpg"}
],
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p"
}
Referenciák hivatkozása a promptban
A prompt a lista pozíciója alapján azonosítja az egyes referenciákat: <IMAGE_0> az elsőnek, <IMAGE_1> a másodiknak, és így tovább. Ha az image paramétert is megadod az első kocka rögzítéséhez, az foglalja el a <IMAGE_0> helyet, és a referenciáid a <IMAGE_1>-től kezdődnek.
Több referencia esetén az xAI azt javasolja, hogy mindegyiknek adj egyetlen szerepet és fix helyet a jelenetben, tartsd korlátozottan a szereplők számát, és használj statikus kellékeket. Ha egy referencia egyszerre szolgál szereplőként és díszletként, vagy tíz tárgy mozog egyszerre, az zavaros jeleneteket eredményez.
A szabályok
| Korlát | grok-imagine-video-1.5 | grok-imagine-video |
|---|---|---|
| Referenciaképek | max. 14 | max. 7 |
| Időtartam | max. 15 mp | max. 10 mp |
| Felbontás | max. 720p | max. 720p |
| Első kép rögzítése referenciákkal, utolsó kép, kulcsképek | Igen | Nem |
Hangok (reference_audios) | max. 3 előre definiált hang | Nem |
Az ilyen típusú kérésnek tartalmaznia kell legalább egy referenciaképet, hangot, utolsó képet vagy kulcsképet.
Konkrét képek rögzítése (grok-imagine-video-1.5)
A grok-imagine-video-1.5 modellen rögzíthetsz pontos képeket a videó meghatározott időpontjaiban:
imageéslast_frameegyütt: a videó az első képből indul és az utolsón ér véget, a modell a kettő között interpolál.last_frameönmagában: a modell kitalálja a nyitányt, és a rögzített képnél landol.last_framereferenciákkal vagy hangokkal: az utolsó kép rögzített, a referenciák irányítják a többit; add hozzá azimageparamétert az első kép rögzítéséhez is.keyframes: legfeljebb négy kulcskép, mindegyikhez egytimestamp_startozik, amely szigorúan 0 és a videó időtartama között van; a horgonyok egyharmad másodperces rácshoz igazodnak, így két kulcsképnek legalább egyharmad másodperccel el kell térnie egymástól.
{
"model": "grok-imagine-video-1.5",
"prompt": "A virág lassan kinyílik a reggeli fényben",
"image": {"url": "https://exemple.com/bouton-ferme.jpg"},
"last_frame": {"url": "https://exemple.com/fleur-ouverte.jpg"},
"keyframes": [
{"image": {"url": "https://exemple.com/fleur-mi-ouverte.jpg"}, "timestamp_s": 3.0}
],
"duration": 6
}
Ugyanez a modell hangot is adhat a szereplőidnek: a reference_audios legfeljebb három előre definiált hangot fogad el, amelyeket a voice_id alapján jelölsz meg (az xAI szövegből-beszédbe hangkatalógusából, például eve vagy leo), és amelyeket a prompt <AUDIO_0>, <AUDIO_1>… formában hivatkozik meg.
Mit tesznek lehetővé a referenciák?
Az első és szakmai szempontból legköltséghatékonyabb felhasználási eset a folytonosság: ugyanaz a szereplő, ugyanaz a termék egyik videóból a másikba. Képzelj el egy tíz videóból álló kampányt, amelyet három hét alatt gyártasz: referenciák nélkül a termék alakja finoman megváltozik, és a kabalafigurának más lesz az arca klippről klippre. Ugyanazon referenciák szisztematikus biztosításával rögzíted azt, aminek változatlannak kell maradnia, és csak a prompt variálja a jelenetet.
{
"model": "grok-imagine-video-1.5",
"prompt": "A <IMAGE_0> okostelefon egy minimalista íróasztalon helyezkedik el; a képernyője fokozatosan bekapcsol, lágy reggeli fényben",
"reference_images": [
{"url": "https://exemple.com/smartphone-officiel.jpg"}
],
"duration": 6
}
A termékelhelyezés ugyanerre a logikára épül – a te üveged, a te cipőd egy kitalált jelenetben –, a virtuális próbafülke pedig továbbviszi ezt: egy személy és egy ruhadarab, mindegyik saját referencián, egyesülve ugyanabban a felvételben.
Referenciák kiválasztása és párosítása
Válassz éles, jól megvilágított képeket, ahol a újrahasznosítandó elem a képkocka nagy részét kitölti: egy semleges háttér előtt egyedül lefotózott ing jobban működik, mint egy tömegben viselt ing. Egy referencia, egy téma.
A prompt megírása követi a szereposztást: a referenciák hozzák az elemeket, a prompt írja le a jelenetet és a cselekvést. Nevezd meg az egyes referenciákat a címkejükkel ott, ahol közreműködnek, és légy egyértelmű a mozgást illetően, amit egyetlen kép sem hordoz.
Egy kérés kezelésekor a döntés egyetlen kérdésre vezethető vissza. Ha egy konkrét képet olyannak akarsz animálni, amilyen, használd az image paramétert. Ha egy új jelenetet szeretnél, ahol adott személyek vagy tárgyak jelennek meg, használd a reference_images paramétert. Ha a kezdetet, a végét vagy konkrét pillanatokat akarod vezérelni, használd a grok-imagine-video-1.5 rögzített képeit. Ha pedig egyik sem számít, önmagában a prompt is elegendő.
Főbb megállapítások
- Az
imageegy képet animál, amely a videó első kockája lesz; areference_imageselemeket jelenít meg anélkül, hogy befagyasztaná az előteret. - A prompt pozíció alapján hivatkozik a referenciákra:
<IMAGE_0>,<IMAGE_1>… (ha meg van adva, azimagefoglalja el a<IMAGE_0>helyet). - Legfeljebb 14 referencia a
grok-imagine-video-1.5modellen (15 mp), 7 agrok-imagine-videomodellen (10 mp), max. 720p felbontás. - A
grok-imagine-video-1.5modellen azimage,last_frame,keyframesésreference_audioskiegészítik a referenciákat. - Referenciánként egy szerep, korlátozott szereplőgárda, statikus kellékek.