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 · Videogeneratie 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 wordt 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 · Videogeneratie 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 · Videogeneratie POST /v1/videos/generations

Invoer: text
Uitvoer: 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 duration en seconds niet beide 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 een invoerafbeelding is opgegeven en de beeldverhouding is weggelaten, neemt de aanbieder 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: Werkelijke ondersteunde invoerafbeelding; hiermee 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 VideogeneratiePOST /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 · Videogeneratie

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 · Videogeneratie

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 werkelijke request_id. Een voltooid antwoord met status=done bevat video.url met een inhouds-URL die je toebehoort. Behoud de gerapporteerde duur en elk teruggestuurd resultaatveld.

Als het oorspronkelijke antwoord moet worden gecontroleerd

Raadpleeg de bestaande oorspronkelijke opdracht; dien een aanvraag met onbekende verzenduitkomst 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`	VoorwaardeDe oorspronkelijke resultaatinhoud is nog niet beschikbaar	Volgende stapVraag de oorspronkelijk teruggestuurde ID herhaaldelijk op en respecteer Retry-After.
Antwoord`server_error`	VoorwaardeDe teruggegeven respons geeft aan dat de bewerking of het resultaat gecontroleerd moet worden	Volgende stapBewaar de oorspronkelijk teruggegeven bewerkings-/taak-ID, aanvraagheaders en respons; blijf de oorspronkelijke bewerking uitlezen via de ondersteunde leesaanvragen. 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