Naar hoofdinhoud gaan
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A candle flickers on a wooden table."
}
'
{
  "request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}
Gebruik dit endpoint om een Grok-videojob te starten vanuit tekst, of vanuit tekst plus één bronafbeelding. Het retourneert onmiddellijk een request_id, dus behandel het als de eerste stap in een async workflow.

​
Begin met een kleine aanvraag

  • Gebruik model: grok-imagine-video
  • Houd voor een snelle test duration op 1 en resolution op 480p
  • Voeg image.url alleen toe wanneer je image-to-video wilt
  • Als je base64 verstuurt, houd dan in de documentatie en het OpenAPI-voorbeeldformulier de vorm data:image/png;base64,<BASE64_IMAGE_DATA> aan

​
Taakstroom

1

Maak de job aan

Verstuur de prompt en sla de geretourneerde request_id op.
2

Poll op voltooiing

Roep Get Video Generation Results aan totdat de geneste providerstatus done wordt.
3

Sla de output op

Kopieer de uiteindelijke video.url naar je eigen opslag als je die nodig hebt na het tijdelijke aflevervenster van de provider.

​
Wat verandert er op CometAPI

xAI documenteert videogeneratie als een tweestapsflow start -> poll. CometAPI behoudt dezelfde request-vorm en dezelfde core model-id, maar je authenticatie verloopt met je CometAPI-sleutel en je blijft op de CometAPI-basis-URL. Een live aanvraag van 1 seconde op 480p werd op 2026-03-12 succesvol voltooid en retourneerde een echte resultaat-URL.

Autorisaties

​
Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
prompt
string
vereist

Prompt for the video job.

Voorbeeld:

"A candle flickers on a wooden table."

​
aspect_ratio
enum<string>

Output aspect ratio.

Beschikbare opties:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
​
duration
integer
standaard:1

Output duration in seconds. xAI documents a range of 1 to 15 seconds.

​
image
object

Optional source image for image-to-video.

​
model
string
standaard:grok-imagine-video

xAI video model id.

Voorbeeld:

"grok-imagine-video"

​
output
object
​
resolution
enum<string>

Output resolution.

Beschikbare opties:
480p,
720p
​
size
string

Deprecated size field. Prefer aspect_ratio and resolution.

​
user
string

Optional end-user identifier.

Respons

200 - application/json

Request accepted.

​
request_id
string
vereist

Deferred request id used for polling.