Képarányok, felbontások és költséggazdálkodás
Ezen az oldalon
Frissítve: 2026. november 3. az xAI videós dokumentációja alapján: az API kilenc képarányt fogad el (beleértve a
21:9-et és az5:2-t) és három felbontást, ahol az1080pelérhetősége modelltől függ; a három videómódell mindegyikének saját árazása van; a régebbi verzió által bemutatottsizeparaméter pixelméretekkel nem szerepel az API referenciában. Források: Videógenerálás · Videos API · Árazás.
Optimalizáld a videógenerálásaidat
Nem elég tudnod, hogyan írj promptot a gyártásba lépéshez. Két tényező dönt a többiről: a kimenetek technikai keretezése és a költségek kontrollálása. Egy stúdió, amely prototípus-stratégia nélkül havi kétszáz klipet generál, többszörösét fizeti a szükséges árnak, és egy csapatnak, amely a projekt végén döbben rá, hogy a formátuma nem illik a terjesztési csatornához, elölről kell kezdenie mindent. Ez a lecke mindkét pontot együtt tárgyalja, mert kölcsönösen hatnak egymásra.
Válaszd ki a megfelelő képarányt
Az aspect_ratio paraméter határozza meg a generált videó arányait. Kilenc érték elfogadott, és mindegyik egy konkrét terjesztési célnak felel meg.
| Arány | Arányok | Elsődleges felhasználás |
|---|---|---|
16:9 | Szélesvásznú fekvő | YouTube, prezentációk, weboldalak |
9:16 | Álló | TikTok, Stories, Reels |
1:1 | Négyzet | Közösségi média bejegyzések, bélyegképek |
4:3 | Klasszikus fekvő | Dokumentumok, diák |
3:4 | Klasszikus álló | Pinterest, poszterek |
3:2 | Fotó fekvő | Portfóliók, galériák |
2:3 | Fotó álló | Poszterek, borítók |
21:9 | Szélesvásznú mozi | Mozis jelenetek |
5:2 | Banner | Webes bannerek, fejlécek |
Ha nincs megadva explicit paraméter, az API az 16:9-et alkalmazza. Ez ésszerű alapértelmezés a webre, de csapdává válik, amint függőleges formátumokat használsz: egy Reels kampánynak minden kérésnél deklarálnia kell a 9:16-ot, különben fekvő videókat kapsz, amelyeket vágni kell, ami a kompozíció elvesztésével jár. Két mód mentesül e beállítás alól: kép-videó (image-to-video) esetén a kimenet követi a forráskép arányát, szerkesztés esetén pedig a forrásvideóét.
Három felbontás, modelltől függően
A resolution paraméter három értéket fogad el. Az alapértelmezett 480p előnézetekhez és piszkozatokhoz készült: a renderelés gyorsabb, így ideális tesztkörnyezet egy prompt validálására, mielőtt végleges minőségben újra futtatnád. A 720p a legtöbb webes és mobilos felhasználáshoz elegendő HD minőséget jelenti. Végül az 1080p Full HD-t biztosít, de nem minden modellen:
| Modell | Maximális felbontás |
|---|---|
grok-imagine-video-1.5 | Natív 1080p (720p referencia-videó esetén) |
grok-imagine-video-1.5-lite | 1080p, 720p-ről történő felskálázással |
grok-imagine-video | 720p |
A szerkesztés nem állítható: az előállított videó megtartja a forrás felbontását, maximum 720p-ig. És nincs ennél finomabb beállítás: az API referencia nem tartalmaz pixelméret paramétert. Ha a terjesztésed pontos dimenziókat igényel, válaszd a legközelebbi arányt és felbontást, majd vágd meg szerkesztés közben.
{
"model": "grok-imagine-video-1.5",
"prompt": "Your description",
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": 5
}
Mibe kerül valójában a gyártás?
Az árat a generált videó másodpercei alapján számítják, és függ a modelltől: 0,020 USD a grok-imagine-video-1.5-lite esetén, 0,050 USD a grok-imagine-video esetén, és 0,080 USD a grok-imagine-video-1.5 esetén. A növekedés tökéletesen lineáris, ami kiszámíthatóvá teszi a költségvetést.
| Időtartam | 1.5-lite | grok-imagine-video | 1.5 |
|---|---|---|---|
| 1 másodperc | 0,02 USD | 0,05 USD | 0,08 USD |
| 3 másodperc | 0,06 USD | 0,15 USD | 0,24 USD |
| 5 másodperc | 0,10 USD | 0,25 USD | 0,40 USD |
| 8 másodperc (alapértelmezett) | 0,16 USD | 0,40 USD | 0,64 USD |
| 10 másodperc | 0,20 USD | 0,50 USD | 0,80 USD |
| 15 másodperc | 0,30 USD | 0,75 USD | 1,20 USD |
- november 3-tól az xAI Models oldala modellenként egyetlen másodpercenkénti árat jelenít meg, felbontás szerinti megkülönböztetés nélkül, míg a Video Overview oldal „felbontásonkénti“ árakra hivatkozik: a nagy tételek commitolása előtt ellenőrizd az ártáblázatot.
Az első optimalizálási kar a modell választása. Az xAI a grok-imagine-video-1.5-lite modellt javasolja egyszerű videókhoz, amely négyszer olcsóbb, mint az 1.5-ös verzió, míg a grok-imagine-video-1.5 akkor szükséges, ha referenciaképekre, hangokra, rögzített képekre vagy natív 1080p-re van szükséged; a szerkesztés és a hosszabbítás meanwhile csak a grok-imagine-video modellel működik. A második kar a próbálkozások száma. Prototipizálj rendszerint röviden: validáld a mozgás irányát két-három másodpercen, mielőtt tíz vagy tizenöt másodperces generálásba kezdenél. Finomítsd a promptot addig, amíg elsőre nem lesz tökéletes, mivel minden újragenerálás teljes árat fizet. Futtasd ezeket a próbákat 480p-ben: a kijelzett ár nem változik, de a rövidült generálási idő gyorsabb iterációt tesz lehetővé. És tartsd észben a sebességkorlátot (rate limit), amikor egy nagyobb tervet ütemezel.
Ezt a számítást könnyű elvégezni. Egy huszonöt, öt másodperces videóból álló projektnél a grok-imagine-video modellel a nyers gyártási költség 20 × 0,25 USD, azaz 5,00 USD (2,00 USD a lite verzióval, 8,00 USD az 1.5-tel). Számolj videónként két átlagos iterációval, és máris 10,00 USD-nél tartasz. Adj hozzá egy 50%-os kísérleti tartalékot, és egy 15,00 USD-s költségvetést prezentálhatsz, ami megállja a helyét. Ez az a nagyságrend, amit közölnöd kell az ügyféllel, nem pedig az első számítás elméleti költsége.
Sebességkorlátok (Rate Limits) kezelése
Az API korlátait kérés másodpercenként mérik, modellenként, és a csapatod szintjével nőnek, amelyet a kumulált költésed határoz meg: a belépő szinten a videómodellek másodpercenként 10 kérést fogadnak el, és ezen túl az API 429 Too Many Requests választ ad (Sebességkorlátok). Általános használatban ezt a limitet ritkán érik el: mivel a generálás aszinkron és hosszú, több időt töltesz várakozással, mint beküldéssel. A kockázat akkor jelenik meg, ha hatalmas tételeket indítasz párhuzamosan, ahol néhány sor kód pillanatok alatt telítheti a kvótát. A beküldések időzítése elegendő a határokon belül maradáshoz.
import asyncio
async def soumettre_lot(prompts, par_seconde=5):
"""Submits generations without exceeding the rate limit."""
for prompt in prompts:
await soumettre_video(prompt) # POST, without waiting for completion
await asyncio.sleep(1 / par_seconde)
Nagyon nagy, várakoztatható tételek esetén az API Batch másik utat kínál: ezek a kérések nem számítanak bele a sebességkorlátokba, és a három videómódell elfogadja őket (bizonyos régiókban csak a grok-imagine-video és a grok-imagine-video-1.5 esetén). Ne várj megtakarítást: a Batch kedvezmény csak a szöveges modellekre vonatkozik, a videót standard áron számlázzák. A feldolgozás általában 24 órán belül megtörténik, garancia nélkül.
A videó letöltés nélküli kézbesítése
Az utolsó hasznos beállítás a gyártásban: az output.upload_url paraméter egy aláírt URL-t (S3 vagy GCS presigned, Azure SAS) jelöl meg, ahová a videó automatikusan elküldésre kerül HTTP PUT módszerrel, a Content-Type: video/mp4 fejléccel, amint generálódott.
{
"model": "grok-imagine-video",
"prompt": "Your description",
"duration": 5,
"output": {
"upload_url": "https://your-storage.com/upload/video.mp4"
}
}
A gyakorlatban ez egy egész lépést vesz ki a pipeline-ból: nem kell letöltened minden fájlt, majd feltöltened a tárhelyedre, a videó közvetlenül a célállomásra érkezik. Napi több tucat klipet érintő forgalom esetén ez annyival kevesebb átviteli kód és hibakezelés, amit karban kell tartani.
Árazás rögzítve: 2026. november 3. — az árak rendszeresen változnak: bármilyen költségvetés-számítás előtt ellenőrizd az aktuális táblázatot a hivatalos xAI modellek és árazás oldalon.
Főbb megállapítások
- Kilenc képarány érhető el, alapértelmezetten a
16:9; kép-videó esetén a kimenet követi a kép arányát - Három felbontás: 480p (alapértelmezett), 720p és 1080p, ez utóbbi csak az 1.5-ös modelleken
- Nincs paraméter a pixelméret beállítására: az arány és a felbontás elegendő
- Az ár lineáris, másodpercenként: 0,020 USD, 0,050 USD vagy 0,080 USD modelltől függően
- Prototipizálj röviden, 480p-ben, a legolcsóbb megfelelő modellel
- Az
output.upload_urlautomatizálja a kézbesítést; az API Batch megkerüli a sebességkorlátokat, de videónál nincs kedvezmény