Skip to main content
POST
cURL
Utilisez ce endpoint pour modifier un MP4 existant à l’aide d’une instruction textuelle. La sortie reste plus proche du rythme et de la composition du clip source qu’une demande 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 montages à environ 8,7 secondes
  • Utilisez une instruction ciblée qui décrit un seul changement clair
  • Enregistrez le request_id renvoyé, car les montages utilisent le même flux d’interrogation que la génération

Flux de modification

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 Obtenir les résultats vidéo xAI jusqu’à ce que la tâche soit terminée.
3

Stocker la ressource modifiée

Téléchargez la sortie finale ou déplacez l’URL renvoyée dans votre propre pipeline de stockage.

Ce qui change sur CometAPI

xAI documente la modification vidéo comme ayant le même cycle de vie asynchrone que la génération, mais 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 de modification 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.

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.