Maak een video met Grok

POST

grok

videos

generations

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A paper boat glides across a quiet pond at sunrise.",
  "duration": 1,
  "aspect_ratio": "16:9",
  "resolution": "480p"
}'

{
  "request_id": "<request_id>"
}

Gebruik dit endpoint om een Grok-videojob te starten vanuit tekst, een bronafbeelding of referentie-invoer. Het retourneert onmiddellijk een request_id, dus behandel dit als de eerste stap in een asynchrone workflow. Verstuur model: grok-imagine-video-1.5 altijd expliciet. model en prompt zijn vereist voor de hier gedocumenteerde 1.5-aanvraagvormen.

Kies een invoermodus

Modus	Aanvraagvelden	Regels
Tekst-naar-video	`prompt`	Laat `image`, `reference_images` en `reference_audios`.
Afbeelding-naar-video	`prompt`, `image.url`	`image.url` accepteert een openbare afbeeldings-URL of een afbeeldingsgegevens-URI. Combineer `image` niet met referentie-invoer.
Referentie-naar-video	`prompt` en ten minste een van `reference_images` of `reference_audios`	Verstuur maximaal 7 referentieafbeeldingen en maximaal 3 vooraf ingestelde stemmen. De uitvoer van Referentie-naar-video is beperkt tot `720p`.

Gebruik voor een data-URI data:image/png;base64,<BASE64_IMAGE_DATA>. Elk item reference_images gebruikt hetzelfde veld url. Een referentie-audio-item gebruikt een vooraf ingestelde voice_id, zoals eve. In de Prompt kunnen tags zoals <IMAGE_0> en <AUDIO_0> de overeenkomstige referentie identificeren.

Begin met een kleine aanvraag

Gebruik model: grok-imagine-video-1.5
Houd voor een eerste aanvraag duration op 1 en resolution op 480p
Houd prompt expliciet, zodat de scène en beweging duidelijk zijn
Voeg één invoermodus tegelijk toe voordat u referentieafbeeldingen en stemmen combineert

Duur en resolutie

Instelling	Ondersteunde waarden	Standaardwaarde	Grensgedrag
`duration`	integer `1`-`15`	`8`	Gebruik kortere clips voor eerste tests; langere clips kosten meer en duren langer om te voltooien.
`resolution`	`480p`, `720p`, `1080p`	`480p`	Aanvragen met een hogere resolutie kosten meer en duren langer om te voltooien. Referentie-naar-video ondersteunt maximaal `720p`.
`aspect_ratio`	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	`16:9` voor tekst-naar-video	Voor afbeelding-naar-video behoudt weglating de beeldverhouding van de bronafbeelding.

Gegenereerde video’s bevatten een audiotrack. Stel duration, resolution en aspect_ratio expliciet in wanneer uw toepassing afhankelijk is van een specifieke uitvoervorm.

Taakstroom

Maak de taak

Verstuur het model, de Prompt en eventuele invoer, en sla vervolgens de geretourneerde request_id op.

Controleer op voltooiing

Roep xAI-videoresultaten ophalen aan totdat status op het hoogste niveau done, failed of expired wordt. Een eerste antwoord kan alleen de teruggestuurde request_id bevatten terwijl taakmetadata wordt voorbereid.

Bewaar de uitvoer

Kopieer de definitieve video.url naar uw eigen opslag als u deze na het tijdelijke leveringsvenster nodig hebt.

Autorisaties

Authorization

string

header

vereist

Use your CometAPI API key as the bearer value.

Body

application/json

model

enum<string>

vereist

The Grok video model ID. Send this field explicitly so the request uses Grok Imagine Video 1.5.

Beschikbare opties:

grok-imagine-video-1.5

Voorbeeld:

"grok-imagine-video-1.5"

prompt

string

vereist

A description of the scene, motion, and audio. Reference-to-video prompts can identify inputs with tags such as <IMAGE_0> and <AUDIO_0>.

Minimum string length: 1

Voorbeeld:

"A paper boat glides across a quiet pond at sunrise."

duration

integer

standaard:8

The output duration in seconds. Use an integer from 1 through 15.

Vereist bereik: 1 <= x <= 15

aspect_ratio

enum<string>

The output aspect ratio. Text-to-video uses 16:9 when omitted. Image-to-video uses the source image's aspect ratio when omitted.

Beschikbare opties:

1:1,

16:9,

9:16,

4:3,

3:4,

3:2,

2:3

Voorbeeld:

"16:9"

resolution

enum<string>

standaard:480p

The output resolution. Reference-to-video requests support 480p and 720p; text-to-video and image-to-video also support 1080p.

Beschikbare opties:

480p,

720p,

1080p

image

object

The source image for image-to-video. Do not combine this field with reference_images or reference_audios.

Show child attributes

reference_images

object[]

Visual references for reference-to-video. Each item accepts a public image URL or image data URI. Do not combine this field with image.

Required array length: 1 - 7 elements

Show child attributes

reference_audios

object[]

Preset voice references for reference-to-video. Do not combine this field with image.

Required array length: 1 - 3 elements

Show child attributes

Respons

200 - application/json

Request accepted.

request_id

string

vereist

The deferred request ID used to poll GET /grok/v1/videos/{request_id}.

Laatst gewijzigd op 21 augustus 2026

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A paper boat glides across a quiet pond at sunrise.",
  "duration": 1,
  "aspect_ratio": "16:9",
  "resolution": "480p"
}'

{
  "request_id": "<request_id>"
}

Contentmoderatie

API-sleutels

Kies een invoermodus

Begin met een kleine aanvraag

Duur en resolutie

Taakstroom

Autorisaties

Body

Respons

​Kies een invoermodus

​Begin met een kleine aanvraag

​Duur en resolutie

​Taakstroom

Autorisaties

Body

Respons

Kies een invoermodus

Begin met een kleine aanvraag

Duur en resolutie

Taakstroom