Muse Video

Muse Video es el modelo de vídeo de Meta Superintelligence Labs. Cada solicitud crea un clip de unos 10 segundos en 720p con sonido a partir de un prompt o de un prompt con hasta 9 imágenes de referencia, en una de siete relaciones de aspecto. Envía la solicitud, conserva el ID de tarea devuelto y lee el vídeo terminado en la tarea. Las imágenes de referencia se envían como URL.

ID de modelo

Consulta los precios actuales en la página del modelo.

Ejemplo rápido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-video",
    "prompt": "Waves rolling onto a sandy beach at sunset, slow camera pan, natural ocean sound. No text.",
    "aspect_ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

La respuesta es una tarea ({"id": "task_...", "status": "processing"}), no el vídeo terminado. Consulta GET /v1/tasks/{task_id} para obtener el resultado. Guarda las claves de API en código del servidor.

Parámetros

Los campos fuera de esta lista se descartan antes de reenviar la solicitud; nunca causan errores ni cambian la salida. No hay ajustes de primer o último fotograma, vídeo de referencia, audio de referencia, extensión, semilla ni prompt negativo. callback_url no está disponible; consulta la tarea.

Imágenes de referencia

Pasa hasta 9 imágenes en image_urls y describe el movimiento en prompt. Muse Video las usa como referencias: el clip se mantiene cercano a ellas, pero el primer fotograma no es una copia píxel a píxel. Si omites aspect_ratio, el clip sigue su forma.

{
  "model": "muse-video",
  "prompt": "The fox slowly lifts its head, wind moving through its fur, the camera pushing in gently, soft forest ambience.",
  "image_urls": ["https://example.com/fox.png"]
}

Entradas multimedia

Cada referencia es una URL pública HTTP(S). No se aceptan URI de datos Base64: sube el archivo a tu propio almacenamiento y pasa su URL. Usa imágenes PNG, JPEG o WebP; los archivos originales de todas las referencias deben sumar 11 MB o menos. Un conjunto que supera ese límite falla después de aceptarse y no se cobra.

Criterios de precio

Consulta las tarifas actuales en la sección de precios del modelo. Muse Video tiene un precio por clip:

cost = price per clip × 1

El precio no se multiplica por los segundos. Las solicitudes solo de texto y con referencias cuestan lo mismo, al igual que todas las relaciones de aspecto. El importe reservado al aceptar la tarea es el que se cobra. Consulta los cargos finales en el historial de uso de tu cuenta. Las tareas fallidas no se cobran.

Esquema de salida

El envío devuelve la tarea:

{"id": "task_...", "model": "muse-video", "status": "processing", "created_at": 1789689600}

Consultar la tarea

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Consulta cada 10–20 segundos hasta que status sea completed o failed. Un timeout de red durante el sondeo no significa que la generación haya fallado: conserva el ID de tarea y sigue consultándolo. No crees otra tarea para comprobar el progreso.

Tarea completada

{
  "id": "task_...",
  "model": "muse-video",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689790,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

En nuestras pruebas, los clips llegaron como archivos MP4 (H.264) de 10,0 segundos con una pista de audio AAC: 1280 × 720 para 16:9, 720 × 1280 para 9:16 y 1248 × 704 para una referencia con formato 16:9, unos 100–200 segundos después del envío.

Errores

Las solicitudes rechazadas antes de crear una tarea devuelven un error HTTP con un objeto error y no se cobran. Una tarea que falla después de aceptarse devuelve HTTP 200 al consultarla, con status: "failed" y un objeto error.

Consulta el catálogo común de errores para ver códigos, estados HTTP y recomendaciones para reintentos.

{
  "id": "task_...",
  "model": "muse-video",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Si el propio envío agota el tiempo de espera, consulta tus tareas antes de volver a enviarlo: la primera solicitud podría haberse aceptado.

Consejos

• Describe el sujeto, la acción, el movimiento de cámara y la luz, e indica los sonidos que quieres; el audio se genera junto con la imagen.
• Crea una imagen con Muse Image y pasa su URL aquí para ponerla en movimiento.
• Para vídeo vertical, envía aspect_ratio: "9:16" o una referencia vertical.
• Añade sin texto para evitar subtítulos inventados.

Relacionado

• Playground y precios de Muse Video
• Referencia de la API de Muse Image
• Descargar OpenAPI
• Markdown para copiar