Édition de vidéo avec /v1/videos/edits — Créer des vidéos avec Grok

Leçon corrigée le 3 novembre 2026 d’après la page Video Editing de xAI : la vidéo source dure 8,7 secondes au plus, la sortie garde sa durée, son ratio et sa résolution (720p au plus), et l’extension utilise le même objet video que l’édition. L’ancienne affirmation selon laquelle l’édition serait peu fiable sur un élément précis contredisait les exemples de xAI, qui portent justement sur des retouches précises. Sources : Video Editing · Video Overview.

Modifier une vidéo existante

Générer n’est qu’une partie du travail. L’API xAI expose également un endpoint d’édition vidéo capable de reprendre une séquence existante et de la modifier à partir d’instructions écrites. C’est l’équivalent vidéo de l’édition d’image, en plus contraint sur les formats. Avant de rédiger votre première requête, notez les quatre bornes qui décideront de ce que vous pouvez lui soumettre.

8,7 s

Durée max de la source

720p

Résolution max

H.265

Codec accepté (comme H.264, AV1)

MP4

Format requis

L’endpoint POST /v1/videos/edits

La requête associe une vidéo source à un prompt décrivant la modification attendue.

{
  "model": "grok-imagine-video",
  "prompt": "Change l'arrière-plan en un coucher de soleil sur la mer",
  "video": {
    "url": "https://exemple.com/video-originale.mp4"
  }
}

Trois champs suffisent : model, qui reste grok-imagine-video ; prompt, qui porte la description de la modification ; et video.url, qui pointe vers le fichier MP4 à traiter. Remarquez que la vidéo est encapsulée dans un objet video, qui accepte une url ou le file_id d’un fichier téléversé : l’endpoint d’extension, à la leçon suivante, adopte la même convention.

Les contraintes techniques sont ici plus serrées qu’en génération. La source ne doit pas dépasser 8,7 secondes, et la vidéo produite garde sa durée ; la page Video Generation parle d’une durée « plafonnée à 8,7 secondes » sans détailler le sort d’une source plus longue : coupez donc vos sources en amont. La résolution plafonne à 720p. Le fichier d’entrée doit être un MP4 dans un codec pris en charge, comme H.264, H.265 ou AV1. Point le plus déroutant pour qui vient de la génération : vous n’avez aucun contrôle sur la durée, le ratio ou la résolution de sortie, tous déterminés par la vidéo source. La requête d’édition ne comporte d’ailleurs aucun champ duration, aspect_ratio ou resolution.

Ce que l’on demande à une édition

Le remplacement d’arrière-plan est le cas d’école : le sujet reste, le décor change.

{
  "model": "grok-imagine-video",
  "prompt": "Remplace l'arrière-plan par un paysage spatial avec des étoiles et des nébuleuses. Garde le même sujet et le même mouvement.",
  "video": {"url": "https://exemple.com/video.mp4"}
}

Le changement de style opère sur l’image entière et transforme le registre du clip sans en modifier l’action — pratique pour décliner une même séquence en plusieurs univers.

{
  "model": "grok-imagine-video",
  "prompt": "Transforme cette vidéo en style dessin animé japonais avec des couleurs vives",
  "video": {"url": "https://exemple.com/video.mp4"}
}

L’ajout d’éléments enrichit la scène de couches qui n’existaient pas au tournage, généralement atmosphériques.

{
  "model": "grok-imagine-video",
  "prompt": "Ajoute de la neige qui tombe et un effet de givre sur les bords",
  "video": {"url": "https://exemple.com/video.mp4"}
}

La modification d’éclairage, enfin, revient à réétalonner la séquence : mêmes plans, ambiance radicalement différente.

{
  "model": "grok-imagine-video",
  "prompt": "Change l'éclairage pour une ambiance de nuit avec des lumières néon bleues et violettes",
  "video": {"url": "https://exemple.com/video.mp4"}
}

Le cycle asynchrone, identique à la génération

L’édition suit exactement le même protocole en quatre temps que la génération : vous envoyez la requête, vous recevez un request_id, vous interrogez GET /v1/videos/{request_id} à intervalles réguliers, et vous récupérez la vidéo éditée quand le statut passe à done. En Python, les deux premières étapes tiennent en quelques lignes.

import httpx

# 1. Soumettre l'édition
response = httpx.post(
    "https://api.x.ai/v1/videos/edits",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "grok-imagine-video",
        "prompt": "Ajoute un effet de pluie sur toute la scène",
        "video": {"url": "https://exemple.com/source.mp4"}
    }
)
request_id = response.json()["request_id"]

# 2. Interroger le statut (simplifié)
status = httpx.get(
    f"https://api.x.ai/v1/videos/{request_id}",
    headers={"Authorization": f"Bearer {api_key}"}
).json()

Dire ce qui change, et ce qui reste

xAI décrit le comportement du modèle en une phrase : grok-imagine-video applique le changement demandé et garde tout le reste aussi proche de la source qu’il le peut. Sa documentation en tire une consigne : dites aussi ce qui doit rester identique. Ses propres exemples portent d’ailleurs sur des retouches précises d’un même clip — ajouter un collier en argent, passer une tenue en rouge, coiffer un personnage d’un chapeau noir à larges bords —, lancées en parallèle sur la même source.

{
  "model": "grok-imagine-video",
  "prompt": "Passe la veste de la femme en rouge. Garde le même visage, le même décor, le même cadrage et le même mouvement.",
  "video": {"url": "https://exemple.com/video.mp4"}
}

Le guide de prompts image de xAI, écrit pour les images fixes, précise l’ordre qui fonctionne : la modification d’abord, puis une phrase qui fixe ce qui ne bouge pas. Une édition qui s’ouvre sur « garde tout » ne change presque rien, et une édition qui recopie un prompt complet réinvente la scène.

Quatre réflexes évitent la majorité des déconvenues : gardez vos sources sous 8,7 secondes, dans un codec pris en charge (H.264, H.265 ou AV1) ; nommez ce qui doit rester intact ; testez une modification sur un clip court avant de la décliner ; et rappelez-vous que l’édition passe par grok-imagine-video, dont la grille affiche un seul prix, $0.050 par seconde — un aller-retour d’essais s’y chiffre comme en génération.

Points clés à retenir

L’endpoint POST /v1/videos/edits modifie une vidéo existante selon un prompt, avec grok-imagine-video seulement
La source dure 8,7 secondes au plus ; la sortie garde sa durée, son ratio et sa résolution (720p au plus)
La vidéo source doit être un MP4 dans un codec pris en charge (H.264, H.265, AV1)
La requête n’a pas de champ duration, aspect_ratio ou resolution
Dites ce qui doit changer, puis ce qui doit rester identique