Passer au contenu principal
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"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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.