Skip to main content

​
Aperçu

Mirage Video est un modèle vidéo conçu spécifiquement pour le réalisme humain. À partir d’une seule image et d’un clip audio, Mirage peut créer des vidéos expressives et réalistes qui capturent les subtils mouvements faciaux, les émotions et la synchronisation labiale avec une fidélité remarquable. Entraîné sur des images humaines diverses, Mirage comprend comment les visages bougent, comment les voix façonnent les expressions et comment de petits détails rendent les personnes réelles à l’écran. L’API Mirage Video expose cette capacité aux développeurs via des endpoints simples :
  • Créer une vidéo — Démarrez une nouvelle génération vidéo à partir d’une paire image-audio.
  • Récupérer une vidéo — Récupérez l’état actuel d’un job de génération vidéo et suivez sa progression.
  • Récupérer le contenu vidéo — Obtenez le MP4 final une fois le job terminé.
  • Lister les vidéos — Accédez à vos générations vidéo récentes.

​
Prérequis

Créez une clé API dans le tableau de bord de la plateforme.

​
1) Créer une vidéo

Fournissez une image portrait (JPEG/PNG) et un audio de parole (WAV/MP3). 
import requests

url = "https://api.mirage.app/v1/videos"
headers = {
    "x-api-key": "<api-key>"
}
files = {
    "image_reference": open("portrait.jpg", "rb"),
    "audio_reference": open("voice.mp3", "rb")
}
data = {
    "model": "mirage-video-1-latest"
}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
Réponse (exemple) 
{
  "id": "video_abc123def456",
  "object": "video",
  "completed_at": 1730822520,
  "created_at": 1730822400,
  "model": "mirage-video-1-latest",
  "progress": 100,
  "status": "COMPLETE",
  "error": null
}

​
2) Vérifier le statut du job

Interrogez jusqu’à ce que le statut devienne COMPLETE. 
import requests

url = f"https://api.mirage.app/v1/videos/{video_id}"
headers = {
    "x-api-key": "<api-key>"
}

response = requests.get(url, headers=headers)
Valeurs de statut
  • PROCESSING
  • COMPLETE
  • FAILED
  • CANCELLED

​
3) Télécharger la vidéo (suivre la redirection)

Une fois le statut d’une vidéo COMPLETE, elle est disponible en téléchargement. L’endpoint content renvoie une redirection HTTP vers l’URL finale de la vidéo. 
import requests

url = f"https://api.mirage.app/v1/videos/{video_id}/content"
headers = {
    "x-api-key": "<api-key>"
}

response = requests.get(url, headers=headers, allow_redirects=True)

with open("output.mp4", "wb") as f:
    f.write(response.content)
Votre vidéo générée est maintenant enregistrée sous output.mp4.

​
Conseils pour de meilleurs résultats

  • Utilisez un portrait clair, de face, bien éclairé avec un seul sujet. Assurez-vous que le visage est bien visible, la bouche ouverte et le sujet orienté en plan rapproché ou plan moyen pour garantir un alignement naturel avec la voix.
  • Évitez les images avec des bouches fermées ou plusieurs personnes dans le cadre.
  • Utilisez un audio expressif et réaliste. Les résultats ont tendance à être moins bons si l’audio est audiblement « généré par IA ».

​
Référence API

Last modified on March 13, 2026