Beeldverhoudingen, resoluties en kostenbeheer
Op deze pagina
Bijgewerkt op 3 november 2026 op basis van de xAI-videodocumentatie: de API accepteert negen beeldverhoudingen (waaronder
21:9en5:2) en drie resoluties, waarbij1080pafhangt van het model; de drie videomodellen hebben elk hun eigen prijsstelling; en de parametersizemet de bijbehorende pixeldimensies, zoals gepresenteerd in de oudere versie, komt niet voor in de API-referentie. Bronnen: Video Generation · Videos API · Pricing.
Optimaliseer uw videogeneraties
Weten hoe u een prompt schrijft, is niet genoeg om naar productie te gaan. Twee factoren bepalen de rest: de technische kaders van uw outputs en kostenbeheer. Een studio die tweehonderd clips per maand genereert zonder prototyping-strategie betaalt meerdere keren de noodzakelijke prijs, en een team dat aan het einde van een project ontdekt dat het formaat niet overeenkomt met het distributiekanaal, moet opnieuw beginnen. Deze les behandelt beide punten samen, omdat ze elkaar beïnvloeden.
Kies de juiste beeldverhouding
De parameter aspect_ratio stelt de verhoudingen van de gegenereerde video in. Er worden negen waarden geaccepteerd, die elk overeenkomen met een specifieke bestemming voor distributie.
| Verhouding | Verhoudingen | Primair gebruik |
|---|---|---|
16:9 | Breedbeeld landschap | YouTube, presentaties, websites |
9:16 | Portret | TikTok, Stories, Reels |
1:1 | Vierkant | Social posts, thumbnails |
4:3 | Klassiek landschap | Documenten, dia’s |
3:4 | Klassiek portret | Pinterest, posters |
3:2 | Fotolandschap | Portfolio’s, galerijen |
2:3 | Fotoportret | Posters, covers |
21:9 | Breedbeeld cinema | Cinematografische opnamen |
5:2 | Banner | Web banners, headers |
Bij afwezigheid van een expliciete parameter past de API 16:9 toe. Dit is een redelijke standaard voor het web, maar het wordt een valstrik zodra u verticale formaten invoert: een campagne bedoeld voor Reels moet bij elk verzoek 9:16 declareren, anders ontvangt u landschapsopnamen die moeten worden bijgesneden, met het verlies aan compositie dat dit met zich meebrengt. Twee modi zijn vrijgesteld van deze instelling: bij image-to-video volgt de output de verhouding van de bronafbeelding, en bij editing die van de bronvideo.
Drie resoluties, afhankelijk van het model
De parameter resolution accepteert drie waarden. De standaardwaarde, 480p, is bedoeld voor previews en concepten: de render is sneller, waardoor het een ideale testomgeving is om een prompt te valideren voordat u deze opnieuw uitvoert op definitieve kwaliteit. 720p komt overeen met HD-kwaliteit die voldoende is voor de meeste web- en mobiele toepassingen. 1080p geeft u tot slot Full HD, maar niet op alle modellen:
| Model | Maximale resolutie |
|---|---|
grok-imagine-video-1.5 | Native 1080p (720p bij reference-to-video) |
grok-imagine-video-1.5-lite | 1080p, via upsampling vanaf 720p |
grok-imagine-video | 720p |
Editing is niet aanpasbaar: de geproduceerde video behoudt de resolutie van de bron, met een maximum van 720p. En er is geen fijnere instelling dan deze stappen: de API-referentie biedt geen parameter voor pixelgrootte. Als uw distributie exacte afmetingen vereist, kiest u de dichtstbijzijnde verhouding en resolutie en snijdt u vervolgens bij in de editing-fase.
{
"model": "grok-imagine-video-1.5",
"prompt": "Your description",
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": 5
}
Wat productie echt kost
De prijs wordt berekend per seconde gegenereerde video en is afhankelijk van het model: $0.020 voor grok-imagine-video-1.5-lite, $0.050 voor grok-imagine-video, en $0.080 voor grok-imagine-video-1.5. De progressie is perfect lineair, wat het budget voorspelbaar maakt.
| Duur | 1.5-lite | grok-imagine-video | 1.5 |
|---|---|---|---|
| 1 seconde | $0.02 | $0.05 | $0.08 |
| 3 seconden | $0.06 | $0.15 | $0.24 |
| 5 seconden | $0.10 | $0.25 | $0.40 |
| 8 seconden (standaard) | $0.16 | $0.40 | $0.64 |
| 10 seconden | $0.20 | $0.50 | $0.80 |
| 15 seconden | $0.30 | $0.75 | $1.20 |
Vanaf 3 november 2026 toont de xAI-pagina Models één prijs per seconde voor elk model, zonder onderscheid naar resolutie, terwijl de pagina Video Overview verwijst naar prijzen “per resolutie”: controleer het tarievenoverzicht voordat u een grote batch commit.
De eerste optimalisatiehefboom is de keuze van het model. xAI raadt grok-imagine-video-1.5-lite aan, vier keer goedkoper dan versie 1.5, voor eenvoudige video’s, en grok-imagine-video-1.5 wanneer u referentieafbeeldingen, stemmen, opgelegde afbeeldingen of native 1080p nodig heeft; editing en extension werken ondertussen alleen met grok-imagine-video. De tweede hefboom is het aantal proefruns. Prototype systematisch kort: valideer de bewegingsrichting op twee of drie seconden voordat u zich committeert aan een generatie van tien of vijftien seconden. Verfijn de prompt totdat deze in één keer goed is, aangezien elke regeneratie de volle prijs kost. Voer deze proefruns uit in 480p: de weergegeven prijs verandert niet, maar de verkorte generatietijd stelt u in staat sneller te itereren. En houd rekening met de rate limit bij het plannen van een batch.
Deze redenering is eenvoudig te berekenen. Voor een project van vijfentwintig video’s van vijf seconden met grok-imagine-video komt de ruwe productie uit op 20 × $0.25, oftewel $5.00 ($2.00 met de lite-versie, $8.00 met 1.5). Ga uit van gemiddeld twee iteraties per video en u zit op $10.00. Tel hier een experimentatiemarge van 50% bij op en u presenteert een budget van $15.00 dat standhoudt. Dit is de orde van grootte die u aan een klant communiceert, niet de theoretische kosten van de eerste berekening.
Omgaan met rate limits
API-limieten worden geteld in requests per seconde, per model, en groeien met de tier van uw team, die zelf wordt bepaald door uw cumulatieve uitgaven: op het instapniveau accepteren videomodellen 10 requests per seconde, en de API reageert daarboven met 429 Too Many Requests (Rate limits). In gewoon gebruik wordt deze limiet zelden bereikt: aangezien generatie asynchroon en langdurig is, bent u meer tijd kwijt aan wachten dan aan indienen. Het risico doet zich voor bij massale batches die parallel worden gestart, waarbij een paar regels code de quota in een ogenblik kunnen verzadigen. Het spreiden van inzendingen is voldoende om binnen de perken te blijven.
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)
Voor zeer grote batches die kunnen wachten, biedt de API Batch een ander pad: de requests hiervan tellen niet mee voor de rate limits, en de drie videomodellen accepteren dit (alleen in bepaalde regio’s voor grok-imagine-video en grok-imagine-video-1.5). Verwacht geen besparingen: de Batch-korting geldt alleen voor tekstmodellen, en video wordt tegen het standaardtarief gefactureerd. De verwerking gebeurt doorgaans binnen 24 uur, zonder garantie.
Lever de video op zonder deze te downloaden
Laatste nuttige instelling in productie: de parameter output.upload_url wijst een ondertekende URL aan (S3 of GCS presigned, Azure SAS) waarheen de video automatisch wordt verzonden via HTTP PUT, met de header Content-Type: video/mp4, zodra deze is gegenereerd.
{
"model": "grok-imagine-video",
"prompt": "Your description",
"duration": 5,
"output": {
"upload_url": "https://your-storage.com/upload/video.mp4"
}
}
In de praktijk verwijdert dit een hele stap uit uw pipeline: het is niet nodig om elk bestand te downloaden en vervolgens naar uw opslag te pushen; de video arriveert direct op zijn bestemming. Bij een stroom van enkele tientallen clips per dag scheelt dat zoveel transfercode en foutafhandeling om te onderhouden.
Prijsstelling vastgelegd op 3 november 2026 — prijzen evolueren regelmatig: controleer voor elke budgetberekening het huidige tarievenoverzicht op de officiële xAI-modellen en prijsstellingspagina.
Belangrijkste punten
- Negen beeldverhoudingen zijn beschikbaar, standaard
16:9; bij image-to-video volgt de output de beeldverhouding - Drie resoluties: 480p (standaard), 720p en 1080p, laatstgenoemde alleen op 1.5-modellen
- Geen parameter stelt een pixelgrootte in: verhouding en resolutie volstaan
- De prijs is lineair, per seconde: $0.020, $0.050 of $0.080 afhankelijk van het model
- Prototype kort, in 480p, met het goedkoopste model dat volstaat
output.upload_urlautomatiseert de levering; de API Batch omzeilt rate limits, zonder korting op video