grok-imagine-video

Grok Imagine Video maakt korte video's uit een tekstbeschrijving, met keuze van duur en beeldformaat. Het xAI-model zelf ondersteunt ook beeldanimatie en gerichte videobewerking.

Ailoot · Videomateriaal POST /v1/videos/generations grok-imagine-video

Over het model

Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.

Van beschrijving naar video

Grok Imagine Video maakt video uit tekst. Het xAI-model zelf heeft ook modi met een bronafbeelding en bronvideo. In de gepubliceerde Ailoot-generatiemethode is de invoer een tekstbeschrijving en het resultaat een video.

Generatie verloopt asynchroon: eerst wordt een taak gemaakt, daarna worden de status en het voltooide resultaat via de taakidentifier opgehaald. Volgens xAI kan het maken van een video meerdere minuten duren; de tijd hangt af van scènecomplexiteit, duur, resolutie en gekozen modus.

Duur en beeldformaat

Voor videocreatie is een duur van 1 tot 15 seconden beschikbaar. De beeldformaten omvatten 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 en 2:3; het standaardformaat is 16:9. Deze versie biedt 480p en 720p; 1080p hoort bij versie 1.5.

De bronafbeelding animeren

In de xAI-modus met een afbeelding wordt die het beginframe en bepaalt de tekstinstructie de beweging. Standaard volgt de videovorm de verhoudingen van de bronafbeelding. Een expliciet opgegeven beeldverhouding verandert die vorm en kan de afbeelding uitrekken.

Gerichte bewerking

Bij een bestaande video past het model de beschreven wijzigingen toe en behoudt het de overige scène-inhoud. Deze modus helpt een gewenst element te wijzigen terwijl de enscenering van de bronvideo behouden blijft. Duur en verhoudingen worden van het origineel overgenomen; een nieuwe duur of beeldvorm worden niet ingesteld.

De bronvideo voor bewerking is beperkt tot 8,7 seconden en het resultaat tot een resolutie van maximaal 720p. Materiaal in 1080p wordt verkleind tot 720p. Instellingen voor videogeneratie op basis van tekst worden niet automatisch op bewerking toegepast.

Een bestaande video verlengen

In een afzonderlijke xAI-modus verlengt deze versie de bronvideo vanaf het laatste frame. De bron-MP4 moet 2 tot 15 seconden duren; het toegevoegde deel 2 tot 10 seconden, standaard 6. Het resultaat combineert de bronvideo met de verlenging. Verhoudingen en resolutie worden uit de bron overgenomen, met een grens van 720p; ze kunnen in deze modus niet afzonderlijk worden veranderd. Deze fabrikantmogelijkheid verschilt van de gepubliceerde Ailoot-generatie uit tekst.

Referenties en versiegrenzen

xAI voorziet in visuele referenties om het uiterlijk van mensen, kleding en voorwerpen in de scène te sturen. Een referentie bepaalt visuele kenmerken, niet het exacte beeld van het eerste frame. Bij de klassieke Grok Imagine Video kunnen een beginframe en referenties niet worden gecombineerd.

Deze versie accepteert geen exacte vastlegging van het laatste frame of tussenliggende keyframes. Die mogelijkheden horen bij Grok Imagine Video 1.5. Generatie, bronbeeldanimatie en het wijzigen van een bestaande video zijn verschillende modi; de gepubliceerde Ailoot-methode beschrijft hier generatie uit tekst.

Ailoot · Videomateriaal POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Aan de slag

Grok Imagine Video maakt korte video's uit een tekstbeschrijving, met keuze van duur en beeldformaat. Het xAI-model zelf ondersteunt ook beeldanimatie en gerichte videobewerking.

Toegestane invoer: Tekst
Resultaten: Video

Beschikbaar in Ailoot · invoer en methoden

Ailoot · Videomateriaal POST /v1/videos/generations

Invoertypen: text
Uitvoertypen: video
Uitvoerformaat: mp4

Veld	Type	Vereiste	Waarden en limieten	Standaard
Veld`model`	Type`string`	VereisteVereist	Waarden en limieten grok-imagine-video	Standaard—
Veld`prompt`	Type`string`	VereisteOptioneel	Waarden en limieten Minimumlengte: 1	Standaard—
Veld`duration`	Type`integer`	VereisteOptioneel	Waarden en limieten Minimum: 1 Maximum: 15 Voorwaarden: Geef niet zowel duration als seconds op Eenheid: seconden	Standaard1
Veld`seconds`	Type`integer\|integer_string`	VereisteOptioneel	Waarden en limieten Minimum: 1 Maximum: 15 Alternatief: duration	Standaard—
Veld`resolution`	Type`string`	VereisteOptioneel	Waarden en limieten 480p, 720p	Standaard480p
Veld`aspect_ratio`	Type`string`	VereisteOptioneel	Waarden en limieten 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Voorwaarden: Als afbeeldingsinvoer is opgegeven en de verhouding is weggelaten, neemt de provider de beeldverhouding van de afbeelding over	Standaard16:9
Veld`size`	Type`string`	VereisteOptioneel	Waarden en limieten 1280x720, 720x1280, 1920x1080, 1080x1920 Voorwaarden: Moet overeenkomen met resolution/aspect_ratio als beide zijn opgegeven	Standaard—
Veld`image`	Type`object`	VereisteOptioneel	Waarden en limieten Voorwaarden: Daadwerkelijk ondersteunde invoerafbeelding; hierdoor mag de prompt worden weggelaten	Standaard—

Combinaties van invoermaterialen

Tekst naar video · Vereist: prompt

Afbeelding naar video · Vereist: image

Methodeparameters en levenscyclus

Parameter	Contract
Parameter`material_types`	Contracttext
Parameter`required`	Contractnull
Parameter`optional_controls`	Contractnull

Levenscyclus: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.

Tarieven

Ailoot-methodetarieven

Ailoot VideomateriaalPOST /v1/videos/generations

Invoer: US$ 0,002 per invoerafbeelding
Invoer: US$ 0,01 per seconde invoervideo
Uitvoer: US$ 0,05 per seconde bij 480p
Uitvoer: US$ 0,07 per seconde bij 720p

Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →

Voorbeeldverzoeken

Ailoot · Videomateriaal

Videovoorbeeld

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

Resultaten ophalen en opslaan

Ailoot · Videomateriaal

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Taakstatus controleren

GET · Status

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

Lezen van andere inhoud

GET · Inhoud

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

Alle voltooide resultaten bewaren

Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.

Bewaar de volledige status-JSON en de daadwerkelijke request_id. Een voltooid antwoord met status=done bevat video.url met een inhouds-URL die u bezit. Behoud de gerapporteerde duur en elk geretourneerd resultaatveld.

Als het oorspronkelijke antwoord moet worden gecontroleerd

Lees de bestaande oorspronkelijke taak; dien een onzekere verzending nooit opnieuw in.

Antwoordvelden

Veld	Type
Veld`request_id`	Typestring
Veld`id`	Typestring
Veld`status`	Typestring
Veld`video.url`	Typeowned signed content URL
Veld`video.duration`	Typenumber
Veld`video.respect_moderation`	Typeboolean

Fouten en vervolgstappen

Antwoord	Voorwaarde	Volgende stap
Antwoord400 · `invalid_request_error`	VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig	Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag.
Antwoord409 · `video_not_ready`	VoorwaardeOorspronkelijke resultaatinhoud nog niet beschikbaar	Volgende stapVraag de oorspronkelijke geretourneerde ID periodiek op en respecteer Retry-After.
Antwoord`server_error`	VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd	Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in.

Aliasnamen

Modelaliasnamen

Ailoot grok-imagine-video

Aliasnamen voor methodepaden

Gebruik de hierboven getoonde methodepaden.

Gerelateerde aanroeper-ID’s

grok-imagine-video

FAQ · grok-imagine-video

Welke invoer en resultaten zijn beschikbaar?: POST /v1/videos/generations · grok-imagine-video: text → video
Welke velden gebruikt het verzoek?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Welke limieten gelden?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video