Montage vidéo avec /v1/videos/edits
Šajā lapā
Mis à jour le 3 novembre 2026. Basé sur la page Video Editing de xAI : la vidéo source fait au maximum 8,7 secondes, la sortie conserve sa durée, son rapport d’aspect et sa résolution (720p max), et l’extension utilise le même objet
videoque le montage. L’affirmation précédente selon laquelle le montage était peu fiable pour des éléments spécifiques contredit les exemples de xAI, qui se concentrent précisément sur des modifications précises. Sources : Video Editing · Video Overview.
Modifier une vidéo existante
La génération ne représente qu’une partie du travail. L’API xAI expose également un point de terminaison de montage vidéo qui prend une séquence existante et la modifie selon des invites textuelles. C’est l’équivalent vidéo du retouchage d’image, avec des contraintes de format plus strictes. Avant d’écrire ta première requête, note les quatre limites qui déterminent ce que tu peux soumettre.
Le point de terminaison POST /v1/videos/edits
La requête associe une vidéo source à une invite décrivant la modification souhaitée.
{
"model": "grok-imagine-video",
"prompt": "Change the background to a sunset over the ocean",
"video": {
"url": "https://example.com/original-video.mp4"
}
}
Trois champs suffisent : model, qui reste grok-imagine-video ; prompt, qui contient la description de la modification ; et video.url, qui pointe vers le fichier MP4 à traiter. Remarque que la vidéo est encapsulée dans un objet video, qui accepte une url ou le file_id d’un fichier téléchargé : le point de terminaison d’extension, dans la prochaine leçon, adopte la même convention.
Les contraintes techniques sont ici plus strictes que lors de la génération. La source ne doit pas dépasser 8,7 secondes et la vidéo produite conserve sa durée ; la page Video Generation mentionne une durée « plafonnée à 8,7 secondes » sans détailler la gestion d’une source plus longue : recadre donc tes sources au préalable. La résolution est limitée à 720p. Le fichier d’entrée doit être un MP4 dans un codec pris en charge, tel que H.264, H.265 ou AV1. Le point le plus déroutant pour ceux venant de la génération : tu n’as aucun contrôle sur la durée, le rapport d’aspect ou la résolution de la sortie, tous déterminés par la vidéo source. La requête de montage ne comprend aucun champ duration, aspect_ratio ou resolution.
Que demander dans un montage
Le remplacement d’arrière-plan est le cas d’école : le sujet reste, le décor change.
{
"model": "grok-imagine-video",
"prompt": "Replace the background with a space landscape with stars and nebulae. Keep the same subject and the same movement.",
"video": {"url": "https://example.com/video.mp4"}
}
Les changements de style affectent l’image entière et transforment le style du clip sans modifier son action — pratique pour adapter la même séquence à différents univers.
{
"model": "grok-imagine-video",
"prompt": "Transform this video into a Japanese cartoon style with vivid colors",
"video": {"url": "https://example.com/video.mp4"}
}
L’ajout d’éléments enrichit la scène avec des couches qui n’existaient pas lors du tournage, généralement atmosphériques.
{
"model": "grok-imagine-video",
"prompt": "Add falling snow and a frost effect on the edges",
"video": {"url": "https://example.com/video.mp4"}
}
Enfin, la modification de l’éclairage revient à réétalonner la séquence : mêmes plans, ambiance radicalement différente.
{
"model": "grok-imagine-video",
"prompt": "Change the lighting to a night ambiance with blue and purple neon lights",
"video": {"url": "https://example.com/video.mp4"}
}
Le cycle asynchrone, identique à la génération
Le montage suit exactement le même protocole en quatre étapes que la génération : tu envoies la requête, tu reçois un request_id, tu interroges GET /v1/videos/{request_id} à intervalles réguliers, et tu récupères la vidéo montée lorsque le statut passe à done. En Python, les deux premières étapes tiennent en quelques lignes.
import httpx
# 1. Soumettre le montage
response = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers={"Authorization": f"Bearer {api_key}"},
json={
"model": "grok-imagine-video",
"prompt": "Add a rain effect over the entire scene",
"video": {"url": "https://example.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()
Préciser 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 conserve tout le reste aussi proche que possible de la source. Sa documentation en déduit une directive : indique aussi ce qui doit rester identique. Ses propres exemples se concentrent également sur des modifications précises d’un seul clip — ajouter un collier en argent, changer une tenue pour du rouge, mettre un chapeau noir à larges bords sur un personnage — exécutés en parallèle sur la même source.
{
"model": "grok-imagine-video",
"prompt": "Change the woman's jacket to red. Keep the same face, the same setting, the same framing, and the same movement.",
"video": {"url": "https://example.com/video.mp4"}
}
Le guide d’invite d’image de xAI, rédigé pour les images fixes, spécifie l’ordre qui fonctionne : la modification d’abord, puis une phrase qui verrouille ce qui reste statique. Un montage qui commence par « garder tout » ne change presque rien, et un montage qui copie une invite de génération complète réinvente la scène.
Quatre habitudes évitent la plupart des pièges : garde tes sources sous les 8,7 secondes, dans un codec pris en charge (H.264, H.265 ou AV1) ; nomme ce qui doit rester intact ; teste une modification sur un court clip avant de l’étendre ; et souviens-toi que le montage utilise grok-imagine-video, dont la grille tarifaire affiche un taux unique, 0,050 $ par seconde — une série d’essais coûte le même prix que la génération.
Galvenās atziņas
- Le point de terminaison
POST /v1/videos/editsmodifie une vidéo existante basée sur une invite, avecgrok-imagine-videouniquement - La source dure au maximum 8,7 secondes ; la sortie conserve sa durée, son ratio et sa résolution (720p max)
- La vidéo source doit être un MP4 dans un codec pris en charge (H.264, H.265, AV1)
- La requête ne comporte aucun champ
duration,aspect_ratioouresolution - Dis ce qui doit changer, puis ce qui doit rester identique