Skip to main content

​
Descripción general

Con la API Mirage, puedes transcribir automáticamente el audio de tu vídeo y renderizar subtítulos animados directamente sobre el vídeo. Elige entre una variedad de plantillas de subtítulos para adaptarlas a tu marca o visión creativa.

​
Requisitos previos

Crea una clave de API en el panel de la plataforma.

​
1) Elige una plantilla de subtítulos

Añadir subtítulos a vídeos requiere una plantilla de subtítulos. Explora todas las plantillas disponibles en la galería de plantillas de subtítulos u obténlas mediante programación. Plantilla de ejemplo: Heat
ID de plantilla de subtítulos 
ctpl_DxflLOnuKkb198FNdI9E

​
2) Añadir subtítulos a un vídeo

Envía tu vídeo junto con un ID de plantilla de subtítulos. Puedes subir un archivo de vídeo directamente o referenciar un ID de vídeo existente de una generación anterior. 
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"
}

# O usa un ID de vídeo existente en lugar de subirlo:
data = {
    "caption_template_id": "ctpl_DxflLOnuKkb198FNdI9E",
    "video_id": "video_abc123def456"
}

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

​
3) Comprobar el estado del trabajo

Comprueba periódicamente hasta que el estado sea 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())
Valores de estado
  • QUEUED
  • PROCESSING
  • COMPLETE
  • FAILED
  • CANCELLED

​
4) Descargar el vídeo

Una vez que el estado sea COMPLETE, descarga tu vídeo subtitulado. 
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)

​
Requisitos del vídeo

  • Relación de aspecto: 9:16 (vertical/retrato)
  • Tamaño máximo: 50 MB
  • Duración máxima: 5 minutos
  • Formatos: MP4, MOV

​
Referencia de la API

Last modified on March 10, 2026