Skip to main content

​
Aperçu

Avec l’API Mirage, vous pouvez transcrire automatiquement l’audio de votre vidéo et afficher de magnifiques sous-titres animés directement sur la vidéo. Choisissez parmi une variété de modèles de sous-titres pour correspondre à votre marque ou vision créative.

​
Prérequis

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

​
1) Choisir un modèle de sous-titres

L’ajout de sous-titres aux vidéos nécessite un modèle de sous-titres. Parcourez tous les modèles disponibles dans la galerie de modèles de sous-titres ou récupérez-les par programmation. Modèle d’exemple : Heat
ID du modèle de sous-titres 
ctpl_DxflLOnuKkb198FNdI9E

​
2) Ajouter des sous-titres à une vidéo

Envoyez votre vidéo avec un ID de modèle de sous-titres. Vous pouvez télécharger un fichier vidéo directement ou référencer un ID de vidéo existant d’une génération précédente. 
import requests

url = "https://api.mirage.app/v1/videos/captions"
headers = {
    "x-api-key": "<api-key>"
}
files = {
    "video": open("input.mp4", "rb")
}
data = {
    "caption_template_id": "ctpl_DxflLOnuKkb198FNdI9E"
}

# Ou utilisez un ID de vidéo existant au lieu de télécharger :
data = {
    "caption_template_id": "ctpl_DxflLOnuKkb198FNdI9E",
    "video_id": "video_abc123def456"
}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
Réponse (exemple) 
{
  "id": "video_cap789xyz",
  "object": "video",
  "status": "PROCESSING",
  "created_at": 1730822600,
  "progress": 0,
  "source_video_id": null,
  "caption_template_id": "ctpl_DxflLOnuKkb198FNdI9E"
}

​
3) 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)
print(response.json())
Valeurs de statut
  • QUEUED
  • PROCESSING
  • COMPLETE
  • FAILED
  • CANCELLED

​
4) Télécharger la vidéo

Une fois le statut COMPLETE, téléchargez votre vidéo sous-titrée. 
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("captioned.mp4", "wb") as f:
    f.write(response.content)

​
Exigences vidéo

  • Format : 9:16 (vertical/portrait)
  • Taille maximale : 50 Mo
  • Durée maximale : 5 minutes
  • Formats : MP4, MOV

​
Référence API

Last modified on March 13, 2026