Riferimento API
Guide all'integrazione
Prezzi e fatturazione
xAI
Generazione video
Usa CometAPI POST /grok/v1/videos/generations per creare video con Grok, animare un’immagine di input tramite prompt e verificare i risultati tramite request_id.
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"
}Usa questo endpoint per avviare un job video Grok da testo, oppure da testo più un’immagine sorgente. Restituisce immediatamente un
request_id, quindi consideralo come il primo passaggio di un flusso di lavoro asincrono.
Inizia con una richiesta piccola
- Usa
model: grok-imagine-video - Per uno smoke test, mantieni
durationa1eresolutiona480p - Aggiungi
image.urlsolo quando vuoi usare image-to-video - Se invii base64, mantieni nei documenti e nell’esempio OpenAPI il formato
data:image/png;base64,<BASE64_IMAGE_DATA>
Flusso del task
Verifica il completamento
Chiama Get Video Generation Results finché lo status del provider annidato non diventa
done.Cosa cambia su CometAPI
xAI documenta la generazione video come un flusso in due passaggi start -> poll. CometAPI mantiene la stessa forma della richiesta e lo stesso id del model principale, ma l’autenticazione avviene con la tua chiave CometAPI e rimani sull’URL base di CometAPI. Una richiesta reale da 1 secondo a 480p è stata completata con successo il 2026-03-12 e ha restituito un URL di risultato reale.Autorizzazioni
Bearer token authentication. Use your CometAPI key.
Corpo
application/json
Prompt for the video job.
Esempio:
"A candle flickers on a wooden table."
Output aspect ratio.
Opzioni disponibili:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. xAI documents a range of 1 to 15 seconds.
Optional source image for image-to-video.
Show child attributes
Show child attributes
xAI video model id.
Esempio:
"grok-imagine-video"
Show child attributes
Show child attributes
Output resolution.
Opzioni disponibili:
480p, 720p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
Risposta
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
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"
}