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

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

// O usa un ID de vídeo existente en lugar de subirlo:
// 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

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

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>'

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)

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

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

Using the API

Video Captioning

Video Generation

Reference

Introducción

Descripción general

Requisitos previos

1) Elige una plantilla de subtítulos

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

3) Comprobar el estado del trabajo

4) Descargar el vídeo

Requisitos del vídeo

Referencia de la API

​Descripción general

​Requisitos previos

​1) Elige una plantilla de subtítulos

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

​3) Comprobar el estado del trabajo

​4) Descargar el vídeo

​Requisitos del vídeo

​Referencia de la API

Descripción general

Requisitos previos

1) Elige una plantilla de subtítulos

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

3) Comprobar el estado del trabajo

4) Descargar el vídeo

Requisitos del vídeo

Referencia de la API