Skip to main content

​
Descripción general

Mirage Video es un modelo de vídeo creado específicamente para el realismo humano. A partir de una sola imagen y un clip de audio, Mirage puede crear vídeos expresivos y realistas que capturan el sutil movimiento facial, las emociones y la sincronización del habla con una fidelidad notable. Entrenado con diversas imágenes humanas, Mirage comprende cómo se mueven los rostros, cómo las voces moldean las expresiones y cómo los pequeños detalles hacen que las personas parezcan reales en pantalla. La API Mirage Video expone esta capacidad a los desarrolladores a través de endpoints sencillos:
  • Crear vídeo — Inicia una nueva generación de vídeo a partir de un par imagen-audio.
  • Recuperar vídeo — Recupera el estado actual de un trabajo de generación de vídeo y realiza un seguimiento de su progreso.
  • Recuperar contenido del vídeo — Obtén el MP4 final una vez que el trabajo esté completo.
  • Listar vídeos — Accede a tus generaciones de vídeo recientes.

​
Requisitos previos

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

​
1) Crear un vídeo

Proporciona una imagen de retrato (JPEG/PNG) y audio de voz (WAV/MP3). 
import requests

url = "https://api.mirage.app/v1/videos"
headers = {
    "x-api-key": "<api-key>"
}
files = {
    "image_reference": open("portrait.jpg", "rb"),
    "audio_reference": open("voice.mp3", "rb")
}
data = {
    "model": "mirage-video-1-latest"
}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
Respuesta (ejemplo) 
{
  "id": "video_abc123def456",
  "object": "video",
  "completed_at": 1730822520,
  "created_at": 1730822400,
  "model": "mirage-video-1-latest",
  "progress": 100,
  "status": "COMPLETE",
  "error": null
}

​
2) 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)
Valores de estado
  • PROCESSING
  • COMPLETE
  • FAILED
  • CANCELLED

​
3) Descargar el vídeo (seguir redirección)

Una vez que el estado de un vídeo es COMPLETE, está disponible para su descarga. El endpoint content devuelve una redirección HTTP a la URL del vídeo final. 
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("output.mp4", "wb") as f:
    f.write(response.content)
Tu vídeo generado ahora está guardado como output.mp4.

​
Consejos para obtener los mejores resultados

  • Usa un retrato claro, de frente, con buena iluminación y un solo sujeto. Asegúrate de que el rostro sea claro, la boca esté abierta y el sujeto esté orientado en un encuadre de primer plano o plano medio para garantizar una alineación natural con la voz.
  • Evita imágenes con bocas cerradas o varias personas en el encuadre.
  • Usa audio expresivo y realista. Los resultados tienden a ser peores si el audio es audiblemente “generado por IA”.

​
Referencia de la API

Last modified on March 10, 2026