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())

const formData = new FormData();
formData.append("caption_template_id", "ctpl_DxflLOnuKkb198FNdI9E");
formData.append("video", await fs.readFile("input.mp4"));

// Ou utilisez un ID de vidéo existant au lieu de télécharger :
// formData.append("video_id", "video_abc123def456");

const response = await fetch("https://api.mirage.app/v1/videos/captions", {
  method: "POST",
  headers: {
    "x-api-key": "<api-key>"
  },
  body: formData
});

const data = await response.json();
console.log(data);

curl --request POST \
  --url https://api.mirage.app/v1/videos/captions \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form caption_template_id=ctpl_DxflLOnuKkb198FNdI9E \
  --form video=@input.mp4

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())

const response = await fetch(`https://api.mirage.app/v1/videos/${videoId}`, {
  method: "GET",
  headers: {
    "x-api-key": "<api-key>"
  }
});

const data = await response.json();
console.log(data);

curl --request GET \
  --url https://api.mirage.app/v1/videos/{video_id} \
  --header 'x-api-key: <api-key>'

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)

const response = await fetch(`https://api.mirage.app/v1/videos/${videoId}/content`, {
  method: "GET",
  headers: {
    "x-api-key": "<api-key>"
  },
  redirect: "follow"
});

curl --request GET \
  --url https://api.mirage.app/v1/videos/{video_id}/content \
  --header 'x-api-key: <api-key>' \
  --location \
  --output output.mp4

Exigences vidéo

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

Using the API

Video Captioning

Video Generation

Reference

Premiers pas

Aperçu

Prérequis

1) Choisir un modèle de sous-titres

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

3) Vérifier le statut du job

4) Télécharger la vidéo

Exigences vidéo

Référence API

​Aperçu

​Prérequis

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

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

​3) Vérifier le statut du job

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

​Exigences vidéo

​Référence API

Aperçu

Prérequis

1) Choisir un modèle de sous-titres

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

3) Vérifier le statut du job

4) Télécharger la vidéo

Exigences vidéo

Référence API