Muse Video API: cómo generar vídeos sin API oficial de Meta

A 2 de noviembre de 2026, Meta no ofrece ninguna API para generar vídeo con Muse Video. Presentó el modelo en vista previa el 7 de julio de 2026 y solo dice que llegará «pronto» a creadores y a Meta AI, sin fecha. La Meta Model API, que sí tiene claves y documentación, sirve Muse Spark y Muse Wonder (texto) y Muse Image (imagen), pero ninguno de sus modelos devuelve vídeo. Hoy los vídeos de Muse se crean a mano en la app Muse, que funciona en Estados Unidos, Canadá, Japón y Singapur, y no en España ni en ningún otro país de la UE.

Si necesitas generar estos vídeos desde código, tienes dos rutas de terceros. useapi.net automatiza tu propia cuenta de Muse por 15 $ al mes, pero esa cuenta tiene que haberse creado en uno de esos cuatro países. El modelo muse-video de LaoZhang API no pide cuenta de Meta: envías POST /v1/videos, consultas el estado y descargas un MP4 de 5 a 10 segundos a 720p con sonido por 0,30 $ el clip. Desde España o la mayor parte de Latinoamérica, donde no se puede abrir una cuenta de Muse, solo te queda esta segunda.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

Si vives en Estados Unidos y solo quieres unos pocos vídeos, el plan gratuito de la app Muse basta y no necesitas ninguna API. Y si tu proyecto exige 1080p o 2K, Muse no te sirve por ninguna de las dos rutas, porque su salida se queda en 720p; ahí conviene otro modelo de vídeo con API propia.

¿Tiene Meta una API de Muse Video? No: solo modelos de texto e imagen

No. La lista oficial de modelos de Meta Model API enumera, a 2 de noviembre de 2026, seis líneas: Muse Wonder, Muse Spark, Muse Image, Muse Voice Transcribe y Segment Anything Model (SAM) se usan a través de la API, y Muse Glimmer se publica con pesos abiertos. Por tipo de salida solo hay texto, imagen y geometría. El vídeo aparece únicamente como entrada: Muse Spark y Muse Wonder pueden leer un vídeo y SAM lo segmenta, pero ningún modelo lo genera.

Muse Video existe como modelo, no como producto para desarrolladores. En el anuncio de Muse Image y Muse Video del blog de Meta AI, del 7 de julio de 2026, Meta Superintelligence Labs lanzó Muse Image y presentó Muse Video en vista previa, construido sobre la misma base de preentrenamiento que Muse Image y con audio nativo. Meta reconoce dos puntos débiles: la sincronización entre audio e imagen y los movimientos rápidos físicamente creíbles. En la clasificación Elo de preferencia humana del Arena de texto a vídeo era tercero a 5 de julio, una foto de aquel momento. Sobre el acceso solo dice «coming soon to creators and Meta AI», sin fecha y sin mencionar una API, así que no hay forma de saber si habrá una versión para desarrolladores ni cuándo.

El nombre también confunde. «Muse» es a la vez la app de agente personal de muse.ai y la marca de toda la familia de modelos, de modo que mucha gente habla de una «Muse API» cuando lo que Meta vende es Meta Model API, que sirve los modelos Muse de texto e imagen, no de vídeo. Tampoco son de Meta las webs que se anuncian como «Generador Muse Video AI», como kling3.io, musevideos.io o musevideo.ai: venden créditos para generar en el navegador, ninguna anuncia una API de Muse Video y una de ellas se describe como de «estilo Meta Muse Video», así que no documentan qué modelo ejecutan.

¿Puedo usar la app Muse desde España o Latinoamérica? Todavía no

A 31 de octubre de 2026, Muse se había lanzado oficialmente en cuatro países: Estados Unidos (8 de septiembre), Canadá (18 de septiembre), Japón (23 de octubre) y Singapur (27 de octubre). No hay anuncio para ningún país del Espacio Económico Europeo, España incluida, ni para Brasil o el resto de Latinoamérica. México aparece junto a Estados Unidos y Canadá en dos publicaciones de Meta en francés y alemán de septiembre, pero sin un lanzamiento propio confirmado. Meta no mantiene una lista única de países; su centro de ayuda dice que Muse «aún no está disponible en todas partes», y las fechas proceden de sus notas de prensa, como la del lanzamiento de Muse en Singapur en la sala de prensa de Meta, recogidas en el seguimiento de disponibilidad de Meta Muse de AI Agents Library.

Lo que cuenta es dónde estás y dónde se creó la cuenta, no el idioma: un hispanohablante en Estados Unidos tiene la app con normalidad. Allí Muse es gratis con un límite de uso que Meta no cuantifica, y tiene dos suscripciones: Power, a 20 $ al mes con 500 millones de tokens de Muse por semana, y Maximum, a 100 $ al mes con 3.000 millones. Meta no publica cuántos tokens consume un vídeo; una referencia es la de useapi.net, que en sus pruebas con el plan gratuito vio que cada vídeo gastaba entre el 2 % y el 3 % de la cuota semanal. Hace falta ser mayor de edad.

El «gratis» de los tutoriales de YouTube que enseñan a crear vídeos y miniseries con Muse se refiere a ese plan gratuito de la app, no a una API: no existe una API gratuita de Muse Video. Si lo que buscas es generar vídeo por API sin pagar, las opciones reales están en API gratis para generar vídeo con IA: qué existe y qué cuesta.

Qué ruta elegir para generar vídeos de Muse desde código

Si estás en España o Latinoamérica y necesitas código, la única ruta que te deja usar Muse es muse-video de LaoZhang API, porque no depende de una cuenta de Muse. Si ya tienes una cuenta de Muse creada en Estados Unidos, Canadá, Japón o Singapur y quieres automatizar los vídeos que tu plan ya incluye, useapi.net aprovecha esa cuota. Para unos pocos vídeos sin programar, la app basta, y si necesitas más resolución, ninguna ruta de Muse sirve.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

useapi.net es un servicio de terceros que inicia sesión en tu cuenta de muse.ai con el correo y la contraseña que le das, algo que Meta no ofrece; según su documentación de la Muse API de useapi.net, una vez configurada la cuenta puedes llamar a la API desde cualquier país, pero la cuenta tiene que crearse en uno de los cuatro países admitidos, así que desde España esta ruta no te sirve. Sus cifras son suyas: en sus pruebas un vídeo tardó entre 60 y 140 segundos, y describe que una cuenta que alcanza el límite de vídeos de las últimas 24 horas queda una hora fuera de los trabajos de vídeo, un límite que Meta no publica. A cambio, a través de useapi.net Muse acepta hasta 9 imágenes, 3 vídeos y 3 audios como entrada, algo que muse-video no ofrece.

muse-video tampoco es de Meta. La guía de Muse Video en la documentación de LaoZhang API dice que la API oficial de Meta aún no tiene modelo de generación de vídeo y que esta integración es independiente y con precio propio; el modelo está disponible desde el 30 de octubre de 2026.

Si el 720p o la falta de vídeo y audio de referencia no te encajan, la propia documentación de LaoZhang API remite a Seedance o Wan para 1080p y a MiniMax H3 para 2K o referencias de vídeo y audio; cómo se comparan esos modelos lo tienes en Wan 3.0 vs MiniMax H3 vs Seedance 2.5: cuál probar primero.

Cómo generar un vídeo de Muse por API: crear, consultar y descargar

El flujo es asíncrono: POST /v1/videos devuelve un id en segundos, consultas GET /v1/videos/{id} cada 15 segundos hasta que el estado sea completed y descargas el MP4 desde video_url. Si vienes de Sora 2, el formato de la petición es el mismo, así que lo principal es cambiar model y poner seconds en 5, 8 o 10; lo que queda por migrar del resto de tu código lo explica La API de Sora 2 ya cerró: qué puedes recuperar y adónde migrar.

1. Crea un token en la gestión de tokens de la consola de LaoZhang API con el grupo default y el modo de facturación «Usage first» o «Per-call». Un token configurado como «Usage-based only» no puede llamar a Muse. Si usas un token solo para vídeo, cuadrarás mejor los cargos con las tareas en el registro de uso.
2. Envía la petición con al menos model y prompt. Sin seconds, muse-video genera 10 segundos; aspect_ratio acepta 16:9, 9:16, 1:1, 4:3 y 3:4, y el prompt admite hasta 20.000 caracteres. Guarda el id que devuelve.
3. Consulta el estado cada 15 segundos durante un máximo de 30 minutos. Mientras sea queued o in_progress, sigue consultando el mismo id y no reenvíes la petición, porque cada envío crea una tarea nueva.
4. Cuando el estado sea completed, descarga el MP4 desde video_url. Ese enlace no necesita cabecera Authorization y caduca a los 7 días; también puedes pedir GET /v1/videos/{id}/content con tu token.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

Con curl y jq los cuatro pasos quedan así:

export LAOZHANG_API_KEY="tu_clave"
export BASE_URL="https://api.laozhang.ai"

# Crear la tarea
curl -s -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "muse-video",
    "prompt": "A lighthouse on a rocky coast at dawn, waves crashing on the rocks, a few seagulls flying past, slow push-in, cinematic lighting",
    "seconds": "10",
    "aspect_ratio": "16:9"
  }' | tee muse-create.json

export VIDEO_ID=$(jq -r '.id' muse-create.json)

# Consultar el estado (repite cada 15 s)
curl -s "$BASE_URL/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" | jq '{status, progress}'

# Descargar cuando status sea "completed"
curl -L -o muse-video.mp4 "$(curl -s "$BASE_URL/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" | jq -r '.video_url')"

En Python, con requests, el mismo flujo con un límite de espera de 30 minutos:

import os
import time

import requests

BASE_URL = "https://api.laozhang.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['LAOZHANG_API_KEY']}"}

task = requests.post(
    f"{BASE_URL}/v1/videos",
    headers=HEADERS,
    json={
        "model": "muse-video",
        "prompt": "A lighthouse on a rocky coast at dawn, waves crashing on the rocks, "
                  "a few seagulls flying past, slow push-in, cinematic lighting",
        "seconds": "10",
        "aspect_ratio": "16:9",
    },
    timeout=120,
)
task.raise_for_status()
video_id = task.json()["id"]  # guárdalo: es lo único que necesitas para recuperar el vídeo

deadline = time.time() + 30 * 60
while True:
    video = requests.get(f"{BASE_URL}/v1/videos/{video_id}", headers=HEADERS, timeout=60).json()
    if video["status"] == "completed":
        break
    if video["status"] == "failed":
        raise RuntimeError(video["error"]["message"])  # ya reembolsada
    if time.time() > deadline:
        raise TimeoutError(f"{video_id} sigue en marcha; vuelve a consultar este mismo id más tarde")
    time.sleep(15)

with open("muse-video.mp4", "wb") as f:
    f.write(requests.get(video["video_url"], timeout=300).content)
print("Guardado muse-video.mp4:", video["seconds"], "segundos")

Qué vídeo devuelve Muse: 720p, 24 fps y sonido siempre activo

Un clip de muse-video en 16:9 sale a 1280×720 y 24 fotogramas por segundo, con una pista de sonido que no se puede desactivar. Son las mediciones con ffprobe de las pruebas que LaoZhang, el operador de laozhang.ai, hizo en su propia pasarela el 30 de octubre de 2026, antes de abrir el modelo: con clips de 5 segundos, 9:16 dio 720×1280, 1:1 dio 960×960, 4:3 dio 1088×816 y 3:4 dio 816×1088, todos a 24 fps y con audio AAC. Enviar resolution: "1080p" o fps: 30 no cambió nada: la petición se acepta y la salida sigue en 720p y 24 fps. El sonido, música y efectos guiados por el prompt, viene siempre; si no lo quieres, quita la pista después de descargar, por ejemplo con ffmpeg -i muse-video.mp4 -an -c:v copy sin-audio.mp4.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

La espera varía mucho. En esas mismas pruebas, los clips de 5 a 10 segundos tardaron entre 1,5 y 2,5 minutos, los de 20 segundos entre 3 y 4, y los de 30 segundos hasta unos 11 minutos; dos clips de 10 segundos con el mismo prompt del faro tardaron unos 103 y unos 395 segundos. La documentación de LaoZhang habla de 2 a 3 minutos habituales para clips de hasta 10 segundos y más de 5 en horas punta, así que programa la espera por estado y no por un tiempo fijo. Los campos style, camera_motion y negative_prompt se reenvían al modelo, pero esas pruebas no verificaron su efecto: úsalos como sugerencias y no cuentes con que un seed reproduzca el mismo vídeo.

Son muestras pequeñas del propio proveedor. La prueba del 1 de noviembre de 2026 no llegó a producir ningún vídeo terminado por el fallo del servicio que se describe en la sección de errores, de modo que no hay una medición propia de la salida que contrastar con estas cifras.

De imagen a vídeo, primer y último fotograma y continuación de un clip

Todas estas variantes usan la misma llamada POST /v1/videos; solo añades campos. image fija el primer fotograma y acepta un enlace público o una data URL; si subes un archivo local en multipart, el campo se llama input_reference, igual que en Sora 2. last_frame fija además el plano final: en las pruebas de LaoZhang del 30 de octubre, image más last_frame dio un clip de 8 segundos que abría y cerraba con encuadres muy parecidos a las imágenes, pero no idénticos píxel a píxel. reference_images admite de 1 a 4 imágenes que aportan sujeto y estilo sin usarse como primer fotograma; con 5 la petición se rechaza con un HTTP 400. Cada imagen puede pesar hasta 10 MB y el enlace tiene que poder descargarse sin iniciar sesión.

Subir una foto local como primer fotograma de un clip vertical de 5 segundos queda así; con -F no añadas la cabecera Content-Type: application/json:

curl -s -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F model=muse-video \
  -F prompt="The kitten blinks and yawns" \
  -F seconds=5 \
  -F aspect_ratio=9:16 \
  -F input_reference=@./gato.jpg

La continuación funciona solo con muse-video-20s y muse-video-30s, que añaden 10 y 20 segundos detrás del clip de origen. Lo pasas en video_url, que debe ser un MP4 descargable por https y de 10 segundos como máximo; vale un video_url que haya devuelto la propia API durante sus 7 días de vida. El resultado incluye el clip de origen, así que 5 segundos continuados con muse-video-20s dan un vídeo de 15 segundos, como confirmaron las pruebas de LaoZhang. Si envías video_url a muse-video, la API responde con un HTTP 400 y no se crea la tarea.

Cuánto cuesta un vídeo de Muse por segundo y por minuto

muse-video cobra por vídeo, no por segundo: 0,30 $ por un clip de 5, 8 o 10 segundos, sin importar la proporción ni si envías imágenes. muse-video-20s cuesta 0,55 $ y muse-video-30s, 0,80 $, según la lista pública de precios de LaoZhang API a 2 de noviembre de 2026. Como el precio es fijo, el coste por segundo baja cuanto más largo es el clip; dividiendo el precio entre los segundos:

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

Un minuto de vídeo sale por 1,80 $ con seis clips de 10 segundos (6 × 0,30 $), por 1,65 $ con tres de 20 (3 × 0,55 $) y por 1,60 $ con dos de 30 (2 × 0,80 $). Son clips sueltos que tienes que unir tú, no un plano continuo de 60 segundos. La continuación sale más cara que un clip largo: 10 segundos con muse-video más 10 de continuación con muse-video-20s suman 20 segundos por 0,85 $ (0,30 $ + 0,55 $), frente a 0,55 $ por un clip de 20 segundos de una vez, así que solo compensa cuando necesitas prolongar un clip concreto. Ninguna de estas cuentas incluye los vídeos que vuelvas a generar porque no te gusta el resultado, que se cobran cada vez; las tareas fallidas no cuentan, porque se reembolsan.

En useapi.net el coste no va por vídeo: pagas 15 $ al mes más tu plan de Muse, y lo que te cabe depende de la cuota semanal. Si se mantiene su cifra del 2 % al 3 % de la semana por vídeo en el plan gratuito, salen entre unos 33 y 50 vídeos semanales (100 ÷ 3 y 100 ÷ 2), una estimación a partir de las pruebas del proveedor, no un límite publicado por Meta. Para situar estos importes frente a otros generadores, los rangos de mercado están en ¿Cuánto cuesta un generador de vídeo con IA? De 0,03 a 0,60 $/s.

Errores de muse-video: cuáles no cobran y cuándo reenviar

El cargo se hace al crear la tarea, así que lo que decide si pagas es si llegó a existir un id. Un error de parámetros devuelve HTTP 400 al enviar, no crea tarea y no cobra; una tarea que falla después se reembolsa entera, y cada reenvío crea una tarea nueva que se cobra de nuevo. Antes de reenviar, mira si tienes un id: si lo tienes, consúltalo; si no, puedes enviar otra vez sin miedo a pagar dos veces.

Las dos primeras filas se comprobaron con peticiones reales el 1 de noviembre de 2026, al margen de las pruebas de LaoZhang. A las 23:37 UTC se enviaron tres peticiones inválidas con un token del grupo default en modo «Per-call», y cada una respondió en un segundo con HTTP 400 y el mensaje tal cual: seconds: "12" en muse-video dio «seconds must be 5, 8, 10 for muse-video.», un video_url en muse-video dio «video_url (continue a video) needs muse-video-20s or muse-video-30s.» y cinco reference_images dieron «Send at most 4 reference_images.». El consumo total de la cuenta era el mismo antes y después, así que no hubo cargo.

Justo después, entre las 23:37 UTC del 1 de noviembre y las 00:07 UTC del 2 de noviembre de 2026, todas las peticiones válidas fallaron, con dos tokens distintos, uno en «Per-call» y otro en «Usage first», e incluso con el ejemplo del faro de la documentación copiado tal cual. Cada una respondió en algo más de un segundo con HTTP 500 y el cuerpo {"error":{"code":"task_protocol_error","message":"Task protocol request failed","type":"new_api_error"}}, sin id de tarea y sin que el consumo se moviera. Es un fallo del lado del servicio, no de tu petición: si ves ese código, no toques los parámetros, espera unos minutos y reenvía, porque no hay ninguna tarea en marcha que puedas duplicar.