Edition de video avec /v1/videos/edits

Modifier une video existante

L’API xAI ne se limite pas a la generation : elle propose egalement un endpoint d’edition video qui vous permet de modifier une video existante a partir d’instructions textuelles. C’est l’equivalent video de l’edition d’image, avec ses propres contraintes et possibilites.

L’endpoint POST /v1/videos/edits

L’endpoint d’edition accepte une video source et un prompt decrivant les modifications souhaitees :

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

Parametres

• model : grok-imagine-video
• prompt : description de la modification souhaitee
• video.url : URL de la video source au format MP4

Contraintes techniques

L’edition video a des limites plus strictes que la generation :

• Duree maximale en sortie : 8.7 secondes. Si votre video source est plus longue, seules les premieres 8.7 secondes seront traitees
• Resolution maximale : 720p
• Format d’entree : MP4 avec codec H.265, H.264, AV1 ou compatible
• Pas de controle sur la duree, le ratio ou la resolution en sortie : ces parametres sont determines par la video source

Types d’editions possibles

Modification d’arriere-plan

{
  "model": "grok-imagine-video",
  "prompt": "Remplace l'arriere-plan par un paysage spatial avec des etoiles et des nebuleuses",
  "video": {"url": "https://exemple.com/video.mp4"}
}

Changement de style

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

Ajout d’elements

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

Modification d’eclairage

{
  "model": "grok-imagine-video",
  "prompt": "Change l'eclairage pour une ambiance nuit avec des lumieres neon bleues et violettes",
  "video": {"url": "https://exemple.com/video.mp4"}
}

Workflow d’edition

Comme pour la generation, l’edition est asynchrone :

1. Envoyez la requete d’edition
2. Recevez un request_id
3. Interrogez le statut via GET /v1/videos/{request_id}
4. Recuperez la video editee une fois le statut done

import httpx

# 1. Soumettre l'edition
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 scene",
        "video": {"url": "https://exemple.com/source.mp4"}
    }
)
request_id = response.json()["request_id"]

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

Limites et bonnes pratiques

Ce qui fonctionne bien

• Les changements de style globaux (anime, peinture, noir et blanc)
• Les modifications d’eclairage et d’ambiance
• L’ajout d’elements atmospheriques (pluie, neige, brume)

Ce qui fonctionne moins bien

• Les modifications precises d’un element specifique dans la scene
• Le remplacement d’objets complexes
• Les changements qui contredisent le mouvement existant

Conseils

• Gardez vos videos source sous 8.7 secondes pour traiter la totalite
• Utilisez des codecs H.265 ou H.264 pour une compatibilite optimale
• Testez sur des clips courts avant d’editer des videos plus longues
• L’edition est facturee au meme tarif que la generation

Points cles a retenir

• L’endpoint POST /v1/videos/edits modifie une video existante selon un prompt
• La duree maximale en sortie est de 8.7 secondes
• La video source doit etre en MP4 avec un codec compatible (H.265, H.264, AV1)
• Pas de controle sur la duree, le ratio ou la resolution en sortie
• Les changements de style et d’ambiance donnent les meilleurs resultats