Vai al contenuto principale
POST
/
grok
/
v1
/
videos
/
edits
Create an xAI video edit job
curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Add snow to the scene.",
  "video": {
    "url": "https://example.com/source.mp4"
  }
}
'
{
  "request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}
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.url raggiungibile
  • Mantieni breve la clip sorgente; le linee guida di xAI limitano le modifiche a circa 8,7 secondi
  • Usa un’istruzione mirata che descriva un solo cambiamento chiaro
  • Salva il request_id restituito, 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

Esegui il polling del risultato finale

Chiama Get Video Generation Results finché il job non è terminato.
3

Archivia l'asset modificato

Scarica l’output finale oppure sposta l’URL restituito nel tuo flusso di storage.

​
Cosa cambia su CometAPI

xAI documenta la modifica video con 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

​
Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
​
prompt
string
obbligatorio

Edit instruction describing the change you want.

Esempio:

"Add snow to the scene."

​
video
object
obbligatorio

Source video to edit. xAI documents an input limit of about 8.7 seconds.

​
model
string
predefinito:grok-imagine-video

xAI video model id.

Esempio:

"grok-imagine-video"

​
output
object

Optional output delivery configuration.

​
user
string

Optional end-user identifier.

Risposta

200 - application/json

Request accepted.

​
request_id
string
obbligatorio

Deferred request id used for polling.