xAI
Creare un video edit xAI
Usa POST /grok/v1/videos/edits per modificare un video sorgente con un prompt testuale, preservare il movimento e ottenere un request_id per interrogare in modo asincrono i risultati.
POST
cURL
Usa questo endpoint per modificare un MP4 esistente con un’istruzione testuale. L’output rimane più vicino alla tempistica e alla composizione della clip sorgente rispetto a una richiesta di generazione da zero.
Prima di inviare la richiesta
- Fornisci un
video.urlraggiungibile - Mantieni breve la clip sorgente; la guida di xAI limita le modifiche a circa 8,7 secondi
- Usa un’istruzione mirata che descriva un solo cambiamento chiaro
- Salva il
request_idrestituito, perché le modifiche usano lo stesso flusso di polling della generazione
Flusso di modifica
1
Invia la richiesta di modifica
Invia l’URL del video sorgente, il prompt di modifica e
model: grok-imagine-video.2
Interroga il risultato finale
Chiama Get xAI video results finché il job non è terminato.
3
Archivia l'asset modificato
Scarica l’output finale oppure sposta l’URL restituito nella tua pipeline di archiviazione.
Cosa cambia su CometAPI
xAI documenta la modifica video come lo stesso ciclo di vita asincrono della generazione, ma con un video sorgente invece di un’immagine sorgente opzionale. CometAPI mantiene questo comportamento e lo stesso endpoint di polling, quindi il tuo flusso di modifica resta comunque avvio -> polling -> download.Autorizzazioni
Bearer token authentication. Use your CometAPI key.
Corpo
application/json
Edit instruction describing the change you want.
Esempio:
"Add snow to the scene."
Source video to edit. xAI documents an input limit of about 8.7 seconds.
xAI video model id.
Esempio:
"grok-imagine-video"
Optional output delivery configuration.
Optional end-user identifier.
Risposta
200 - application/json
Request accepted.
Deferred request id used for polling.