Hopp til hovedinnhold
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"
}
Bruk dette endepunktet for å starte en Grok-videojobb fra tekst, eller fra tekst pluss ett kildebilde. Det returnerer en request_id umiddelbart, så behandle det som første steg i en asynkron arbeidsflyt.

Start med en liten forespørsel

  • Bruk model: grok-imagine-video
  • For en enkel test, hold duration1 og resolution480p
  • Legg til image.url bare når du vil bruke image-to-video
  • Hvis du sender base64, behold dokumentasjonen og OpenAPI-eksempelformatet som data:image/png;base64,<BASE64_IMAGE_DATA>

Oppgaveflyt

1

Opprett jobben

Send prompten og lagre den returnerte request_id.
2

Hent status til den er fullført

Kall Get Video Generation Results til den nøstede provider-statusen blir done.
3

Lagre outputen

Kopier den endelige video.url til din egen lagring hvis du trenger den etter providerens midlertidige leveringsvindu.

Hva endres på CometAPI

xAI dokumenterer videogenerering som en totrinns start -> poll-flyt. CometAPI beholder samme forespørselsformat og samme kjerne-model-id, men du autentiserer med CometAPI-nøkkelen din og blir på CometAPI sin base-URL. En live 1-sekunds 480p-forespørsel ble fullført uten problemer 2026-03-12 og returnerte en ekte resultat-URL.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Kropp

application/json
prompt
string
påkrevd

Prompt for the video job.

Eksempel:

"A candle flickers on a wooden table."

aspect_ratio
enum<string>

Output aspect ratio.

Tilgjengelige alternativer:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
duration
integer
standard: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
standard:grok-imagine-video

xAI video model id.

Eksempel:

"grok-imagine-video"

output
object
resolution
enum<string>

Output resolution.

Tilgjengelige alternativer:
480p,
720p
size
string

Deprecated size field. Prefer aspect_ratio and resolution.

user
string

Optional end-user identifier.

Svar

200 - application/json

Request accepted.

request_id
string
påkrevd

Deferred request id used for polling.