Skip to main content

​
Übersicht

Mit der Mirage API können Sie das Audio Ihres Videos automatisch transkribieren und schön animierte Untertitel direkt auf das Video rendern. Wählen Sie aus einer Vielzahl von Untertitelvorlagen, die zu Ihrer Marke oder kreativen Vision passen.

​
Voraussetzungen

Erstellen Sie einen API-Schlüssel im Plattform-Dashboard.

​
1) Untertitelvorlage auswählen

Um Untertitel zu Videos hinzuzufügen, ist eine Untertitelvorlage erforderlich. Durchsuchen Sie alle verfügbaren Vorlagen in der Untertitelvorlagen-Galerie oder rufen Sie sie programmgesteuert ab. Beispielvorlage: Heat
Untertitelvorlage-ID 
ctpl_DxflLOnuKkb198FNdI9E

​
2) Untertitel zum Video hinzufügen

Senden Sie Ihr Video zusammen mit einer Untertitelvorlage-ID. Sie können eine Videodatei direkt hochladen oder auf eine vorhandene Video-ID aus einer früheren Generierung verweisen. 
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"
}

# Oder verwende eine vorhandene Video-ID statt eines Uploads:
data = {
    "caption_template_id": "ctpl_DxflLOnuKkb198FNdI9E",
    "video_id": "video_abc123def456"
}

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

​
3) Job-Status prüfen

Abfragen, bis der Status COMPLETE ist. 
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())
Statuswerte
  • QUEUED
  • PROCESSING
  • COMPLETE
  • FAILED
  • CANCELLED

​
4) Video herunterladen

Wenn der Status COMPLETE ist, laden Sie Ihr untertiteltes Video herunter. 
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)

​
Videoanforderungen

  • Seitenverhältnis: 9:16 (vertikal/Hochformat)
  • Maximale Dateigröße: 50 MB
  • Maximale Dauer: 5 Minuten
  • Formate: MP4, MOV

​
API-Referenz

Last modified on March 10, 2026