Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Endpoint /v1/videos/generations: Uw eerste video

Les 1 van 12 Bijgewerkt op 3 november 2026 Gemiddeld
Op deze pagina
  1. Een video genereren vanuit tekst
  2. Structuur van de aanvraag
  3. Een eerste end-to-end-aanroep
  4. Audio, standaard inbegrepen
  5. Belangrijkste punten

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 en grok-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 parameter size uit 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.

1-15s
Duur per video
1080p
Maximale resolutie
vanaf $0,02
Per gegenereerde seconde
9
Beschikbare verhoudingen

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 versie grok-imagine-video-1.5-lite (aanbevolen door xAI voor eenvoudige video’s) of grok-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), 720p of 1080p. Dit laatste wordt native gerenderd door grok-imagine-video-1.5 bij text-to-video en image-to-video, verkregen door upsampling van 720p bij de -lite-versie, en afwezig bij grok-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, met grok-imagine-video-1.5, de -lite-versie of grok-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_id om vervolgens te pollen
  • Er zijn negen beeldverhoudingen beschikbaar om aan alle formaten te voldoen
  • Standaard wordt een audiospoor gegenereerd; "generate_audio": false levert een stille video op