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

const formData = new FormData();
formData.append("model", "mirage-video-1-latest");
formData.append("image_reference", await fs.readFile("portrait.jpg"));
formData.append("audio_reference", await fs.readFile("voice.mp3"));

const response = await fetch("https://api.mirage.app/v1/videos", {
  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 \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form model=mirage-video-1-latest \
  --form image_reference=@portrait.jpg \
  --form audio_reference=@voice.mp3

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)

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

const data = await response.json();

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

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)

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

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”.

Using the API

Video Captioning

Video Generation

Reference

Introducción

Descripción general

Requisitos previos

1) Crear un vídeo

2) Comprobar el estado del trabajo

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

Consejos para obtener los mejores resultados

Referencia de la API

​Descripción general

​Requisitos previos

​1) Crear un vídeo

​2) Comprobar el estado del trabajo

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

​Consejos para obtener los mejores resultados

​Referencia de la API

Descripción general

Requisitos previos

1) Crear un vídeo

2) Comprobar el estado del trabajo

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

Consejos para obtener los mejores resultados

Referencia de la API