Endpoint /v1/videos/generations: Uw eerste video
Op deze pagina
Bijgewerkt op 3 november 2026 op basis van de xAI-videodocumentatie: er zijn drie videomodellen beschikbaar (
grok-imagine-video-1.5, de-lite-versie ervan engrok-imagine-video), de resolutie gaat tot 1080p bij de 1.5-modellen, video’s hebben standaard een audiospoor (generate_audio) en tarieflimieten worden geteld in aanvragen per seconde. De parametersizeuit de oude versie komt niet voor in de API-referentie. Bronnen: Video Generation · Pricing.
Een video genereren vanuit tekst
De API van xAI biedt een specifiek video-endpoint, POST /v1/videos/generations, dat een geschreven beschrijving omzet in een geanimeerde reeks met behulp van een van de drie Grok Imagine Video-modellen. Zie het als een studio op aanvraag: u beschrijft een scène, het model brengt deze in beweging en u ontvangt een MP4-bestand dat klaar is voor bewerking. Promotieclips, conceptvisualisaties, illustratieve animaties; al deze use-cases lopen via ditzelfde endpoint, dus we ontleden dit eerst.
Het bovenstaande voorbeeld geeft u een idee van het verwachte resultaat. Houd voordat u uw eerste aanvraag schrijft rekening met de vier grenswaarden die alles kaderen wat u met deze modellen produceert.
Structuur van de aanvraag
De request body is een JSON-object van geruststellende eenvoud. U declareert het model, schrijft uw prompt en kadert het resultaat met drie opmaakparameters.
{
"model": "grok-imagine-video",
"prompt": "A dolphin jumping in a sunset",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}
Hier is de exacte betekenis van elk veld:
- model:
grok-imagine-video-1.5(de nieuwste), de zuinige versiegrok-imagine-video-1.5-lite(aanbevolen door xAI voor eenvoudige video’s) ofgrok-imagine-video(de vorige generatie, nog steeds gebruikt in de voorbeelden van deze cursus) - prompt: uw tekstuele beschrijving van de gewenste scène
- duration: duur in seconden, tussen 1 en 15 (standaard 8)
- aspect_ratio: beeldverhouding (standaard 16:9; opties: 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, 5:2)
- resolution:
480p(standaard),720pof1080p. Dit laatste wordt native gerenderd doorgrok-imagine-video-1.5bij text-to-video en image-to-video, verkregen door upsampling van 720p bij de-lite-versie, en afwezig bijgrok-imagine-video, dat stopt bij 720p.
Twee punten verdienen nu direct nadruk. Het model grok-imagine-video kost $0,050 per seconde gegenereerde video ($0,08 voor grok-imagine-video-1.5, $0,02 voor de -lite-versie, per 3 november 2026): een reeks van vijf seconden kost u dus $0,25 met het eerste model, ongeacht hoeveel pogingen u heeft gedaan. De tarieflimiet wordt geteld in aanvragen per seconde, afhankelijk van het tier van uw team: 10 bij het instaptier voor videomodellen. Dit is een comfortabele marge voor normaal gebruik, maar wordt een beperking wanneer u massale batches lanceert.
Belangrijker nog: de generatie is asynchroon. Uw POST-aanroep retourneert geen video: het retourneert een request_id. Het is vervolgens aan u om de status te pollen totdat het bestand klaar is. Dit polling-mechanisme is het onderwerp van een volledige les later in de cursus; onthoud voor nu alleen dat de directe respons een bevestiging is, geen resultaat.
Een eerste end-to-end-aanroep
Laten we in de praktijk stappen met curl. De volgende aanvraag bestelt een reeks van vijf seconden in 720p, landscape-formaat.
curl -X POST "https://api.x.ai/v1/videos/generations" \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "A cat playing with a ball of yarn in a bright living room",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'
De respons past op één regel:
{
"request_id": "vid_abc123def456"
}
Bewaar deze identifier zorgvuldig. Het is uw enige manier om de video op te halen zodra de generatie voltooid is. Een applicatie die deze kwijtraakt, heeft betaald voor een generatie die het nooit zal ophalen. In een echte service logt u deze voordat u zelfs maar begint met pollen.
Audio, standaard inbegrepen
Een gegenereerde video bevat standaard een audiospoor. Bij grok-imagine-video-1.5 en de -lite-versie is de spraak gesynchroniseerd met de lipbewegingen. Voor een stille video, bijvoorbeeld bedoeld als achtergrond voor een website of voor bewerking waarbij u uw eigen muziek toevoegt, voegt u "generate_audio": false toe aan de aanvraag.
Om de output te kaderen, kent de API echter alleen de verhouding (aspect_ratio) en de definitie (resolution): de API-referentie biedt geen parameter voor pixelgrootte. Bij image-to-video volgt de uitvoerverhouding altijd die van de bronafbeelding.
Belangrijkste punten
- Het endpoint is
POST /v1/videos/generations, metgrok-imagine-video-1.5, de-lite-versie ofgrok-imagine-video - De duur varieert van 1 tot 15 seconden (standaard 8), de resolutie van 480p tot 1080p (maximaal 720p met
grok-imagine-video) - De prijs wordt per gegenereerde seconde berekend: $0,020 (
-lite), $0,050 (grok-imagine-video) of $0,080 (grok-imagine-video-1.5) - Generatie is asynchroon: u ontvangt een
request_idom vervolgens te pollen - Er zijn negen beeldverhoudingen beschikbaar om aan alle formaten te voldoen
- Standaard wordt een audiospoor gegenereerd;
"generate_audio": falselevert een stille video op