Édition vidéo

Utilisez POST /grok/v1/videos/edits pour modifier une vidéo source avec un Prompt textuel, préserver le mouvement et obtenir un request_id pour interroger les résultats asynchrones.

POST /grok/v1/videos/edits

Create an xAI video edit job

cURL

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"
  }
}
'

200

{
  "request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}

Utilisez cet endpoint pour modifier un fichier MP4 existant à l’aide d’une instruction textuelle. Le résultat reste plus proche du timing et de la composition du clip source qu’une requête de génération entièrement nouvelle.

​

Avant d’envoyer la requête

• Fournissez un video.url accessible
• Gardez le clip source court ; les recommandations de xAI limitent les modifications à environ 8,7 secondes
• Utilisez une instruction ciblée qui décrit une seule modification claire
• Enregistrez le request_id renvoyé, car les modifications utilisent le même flux d’interrogation que la génération

​

Flux d’édition

1. Soumettre la requête de modification

   Envoyez l’URL de la vidéo source, le prompt de modification et model: grok-imagine-video.

2. Interroger le résultat final

   Appelez Get Video Generation Results jusqu’à ce que la tâche soit terminée.

3. Stocker l’asset modifié

   Téléchargez le résultat final ou transférez l’URL renvoyée vers votre propre pipeline de stockage.

​

Ce qui change sur CometAPI

xAI décrit l’édition vidéo comme ayant le même cycle de vie asynchrone que la génération, simplement avec une vidéo source au lieu d’une image source facultative. CometAPI conserve ce comportement ainsi que le même endpoint d’interrogation, donc votre workflow d’édition reste démarrer -> interroger -> télécharger.

Autorisations

Authorization · string · header · requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json

prompt · string · requis

Edit instruction describing the change you want.

Exemple:

"Add snow to the scene."

video · object · requis

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

Show child attributes

model · string · défaut: grok-imagine-video

xAI video model id.

Exemple:

"grok-imagine-video"

output · object

Optional output delivery configuration.

user · string

Optional end-user identifier.

Réponse

200 - application/json

Request accepted.

request_id · string · requis

Deferred request id used for polling.