Precios de la API de Luma: documentación de Ray 3.2 y costo por clip
Ray 3.2 cuesta $0.30 por un clip de 5 segundos a 720p en la API de Luma y $1.20 a 1080p. Consulta todas las tarifas SDR, HDR y EXR, el formato de las solicitudes, los límites de uso, los errores 429 y formas de reducir la factura, además de una opción sin código en PicassoIA.
Un clip de 5 segundos a 720p con Ray 3.2 cuesta $0.30 en la API de Luma. Si subes el mismo clip a 1080p, el precio sube a $1.20. Si además exportas en HDR y EXR a 1080p, una toma de cinco segundos cuesta $3.60. Estas cifras salen directamente de la página de precios de Luma, y deciden si un proyecto de 200 clips cuesta lo que una comida o lo que un equipo portátil. Este artículo recoge todas las tarifas de Ray 3.2, explica la documentación de la API para que puedas enviar una primera solicitud, señala las combinaciones de parámetros que la API rechaza y muestra cómo mantener baja la factura. Si prefieres no escribir código, también hay una sección sobre cómo usar Ray 3.2 en PicassoIA desde el navegador.
💡 Luma indica que las tarifas de video están sujetas a cambios antes de la disponibilidad general. Revisa de nuevo la página de precios en docs.agents.lumalabs.ai antes de fijar un presupuesto.
Precios de la API de Ray 3.2 de un vistazo
Luma cobra Ray 3.2 por duración del clip y calidad de salida, no por número de tokens. Cada generación cae en un bloque fijo de 5 o 10 segundos, y el precio sube con la resolución y el rango dinámico. El video a partir de texto y el video a partir de imagen comparten la misma tabla de tarifas, así que un clip animado a partir de una foto cuesta lo mismo que uno escrito desde un prompt.
Tarifas de rango dinámico estándar
El rango dinámico estándar (SDR) es la salida por defecto, y es la tarifa que pagan la mayoría de los proyectos.
Resolución
Clip de 5 segundos
Clip de 10 segundos
Ideal para
360p (borrador)
$0.06
$0.18
Probar prompts
540p
$0.15
$0.45
Vistas previas rápidas
720p
$0.30
$0.90
Publicaciones en redes y web
1080p
$1.20
$3.60
Entrega final
El salto de 720p a 1080p merece una segunda mirada. Un fotograma de 1080p tiene 2.25 veces los píxeles de uno de 720p, pero el precio sube 4 veces. A menos que el destino realmente muestre 1080p, el nivel más barato es la opción predeterminada más inteligente.
Tarifas de exportación HDR y EXR
HDR está limitado a clips de 5 segundos a 720p o 1080p. La exportación EXR, el archivo de color sin procesar para la corrección profesional, se suma al HDR.
Modo
720p
1080p
SDR
$0.30
$1.20
HDR
$0.60
$2.40
HDR + exportación EXR
$0.90
$3.60
HDR duplica el precio del SDR, y añadir EXR lo triplica. Si el clip va a Instagram o a una página de destino, nada en la cadena de visualización mostrará ese rango extra, así que omite HDR y EXR y ahorra dos tercios.
Tarifas de reencuadre y extensión
Otras dos operaciones tienen tarifas propias, ambas solo para rango dinámico estándar.
Reencuadre (cambiar la relación de aspecto de un video existente) se cobra por segundo: $0.03 a 360p, $0.06 a 540p, $0.12 a 720p y $0.36 a 1080p.
Extender desde un único fotograma de anclaje se cobra como un bloque de 5 segundos: $0.15 a 540p, $0.30 a 720p y $1.20 a 1080p.
Edición de video tiene tarifas separadas para SDR, HDR y HDR + EXR con niveles de 5 y 10 segundos, todas con tarifas base más altas que la generación normal. Consulta las cifras exactas de edición en la página de precios.
Hay una cifra que conviene recordar. Reencuadrar un clip de 5 segundos a 720p cuesta 5 × $0.12 = $0.60. Generar un clip nuevo en 9:16 de forma nativa cuesta $0.30. Si solo necesitas la versión vertical y no la toma original exacta, genérala desde el principio con la relación correcta.
Lo que cuesta realmente un clip
Costo por segundo según el nivel
Dividir cada bloque entre su duración da una cifra más fácil de comparar con otras herramientas de video.
Nivel
Precio del bloque
Por segundo
360p borrador
$0.06
$0.012
540p
$0.15
$0.030
720p
$0.30
$0.060
1080p
$1.20
$0.240
720p HDR
$0.60
$0.120
1080p HDR
$2.40
$0.480
1080p HDR + EXR
$3.60
$0.720
Un minuto de metraje terminado, hecho con doce clips de 5 segundos, cuesta $3.60 a 720p y $14.40 a 1080p. Esto supone que conservas todas las tomas, algo que nadie hace.
Dos clips de 5 segundos salen mejor que uno de 10
Un clip de 10 segundos a 720p cuesta $0.90. Dos clips de 5 segundos cuestan $0.60. Eso hace que el bloque más largo sea un 50% más caro por segundo, y el mismo patrón se mantiene en todas las resoluciones. A 1080p la diferencia es de $3.60 frente a $2.40.
La opción de 10 segundos también tiene restricciones. La API rechaza 10s junto con HDR, un fotograma inicial, un fotograma final o loop. Así que la ruta más barata suele ser también la más flexible. Genera el primer clip, toma su último fotograma y pásalo como fotograma inicial del segundo clip para que el movimiento continúe sin un salto visible.
Ejemplos de presupuesto
Proyecto
Clips
Ajustes
Costo
Lote de prueba para redes sociales
40
540p, 5s
$6,00
Canal semanal
100
720p, 5s
$30,00
Video de lanzamiento de producto
60
1080p, 5s
$72,00
Pipeline de gradación de color
25
1080p HDR + EXR, 5s
$90,00
Ahora añade la parte que más presupuestos olvidan. Si conservas una toma de cada tres, multiplica por tres. El canal semanal con 100 clips útiles pasa a 300 generaciones, o $90 en lugar de $30.
Incluye ese multiplicador en cada estimación que envíes a un cliente. Un precio fijo por clip parece barato hasta que un director pide la cuarta variación de la misma toma. Registra los clips aceptados frente a los generados durante la primera semana y tendrás una tasa de reintentos real. Esa sola cifra hace que todas las previsiones posteriores sean más honestas.
Recorrido por la documentación de la API de Ray 3.2
Luma publica Ray 3.2 en la documentación de su API de Agents. Tres cosas importan antes de tu primera llamada: la URL base, la cabecera de autenticación y la forma de la solicitud.
URL base y autenticación
La URL base es https://agents.lumalabs.ai/v1. La autenticación usa un token bearer en la cabecera Authorization. Guarda el token en una variable de entorno y nunca lo subas a un repositorio. Existen SDK oficiales para Python y TypeScript (ambos llamados luma-agents) y para Go (luma-agents-go), además de una herramienta de línea de comandos.
La solicitud de generación
Todo empieza con POST /v1/generations. Tres campos son obligatorios:
model: con el valor "ray-3.2"
type: con el valor "video"
prompt: de 1 a 6,000 caracteres que describan el sujeto, el movimiento, el movimiento de cámara, la iluminación y el ritmo
Los campos opcionales ajustan la salida. aspect_ratio acepta 9:16, 3:4, 1:1, 4:3, 16:9 o 21:9. El objeto video admite resolution (360p, 540p, 720p por defecto, o 1080p), duration ("5s" por defecto o "10s"), además de los booleanos hdr y loop.
Esa solicitud se cobra a $0.30: 720p, 5 segundos, rango dinámico estándar.
Consulta del estado del trabajo
Un envío correcto devuelve HTTP 201 con el estado queued. Consulta GET /v1/generations/{id} hasta que el trabajo llegue a un estado final, ya sea de éxito o failed. Si el trabajo tiene éxito, la salida incluye una URL firmada para el MP4. Los enlaces firmados son temporales por diseño, así que copia el archivo a tu propio almacenamiento de inmediato.
Calcula unos 80 a 200 segundos por clip. Las ejecuciones de ejemplo en la página de Ray 3.2 de PicassoIA tardaron entre 79 y 204 segundos, así que consultar cada 5 a 10 segundos es suficiente.
Reglas de parámetros que provocan errores
Una solicitud rechazada desperdicia un viaje de ida y vuelta, y una regla mal entendida desperdicia una tarde. La documentación de Luma detalla qué opciones no se pueden combinar.
Conflictos de HDR, loop y 10s
Opción
Rechazada junto con
Duración 10s
HDR, fotograma inicial, fotograma final, loop
HDR
360p, 540p, 10s, loop
Loop
10s, HDR, fotograma final, control de varios fotogramas
360p o 540p
HDR
Valida estas reglas en tu propio código antes de llamar a la API. Una pequeña función que compruebe la combinación se escribe en diez minutos y elimina toda una clase de trabajos fallidos.
Límites de uso y errores 429
Se aplican dos límites independientes a POST /v1/generations:
Solicitudes por minuto (RPM): el número máximo de solicitudes en una ventana deslizante de 60 segundos.
Trabajos concurrentes: el número máximo de generaciones activas en cualquier momento.
Luma no publica cifras exactas. Tus límites dependen de tu plan y aparecen en el panel de la plataforma de Luma. Ambos límites devuelven HTTP 429, y el cuerpo de la respuesta permite distinguirlos.
Ajusta un semáforo en tu worker al límite de concurrencia que aparece en tu panel, y respeta Retry-After en lugar de reintentar con un temporizador fijo. Reparte un lote grande a lo largo del minuto en lugar de lanzar todas las solicitudes a la vez, y la ventana de RPM deja de ser un problema.
Formas de mantener baja la factura
Borrador a 360p primero
El nivel de borrador a 360p cuesta $0.06, una quinta parte de un clip de 720p y una veinteava parte de uno de 1080p. Prueba cada prompt ahí y luego pasa a calidad final solo los ganadores.
Supón que necesitas 25 tomas a 1080p. Renderizar las 25 directamente a 1080p cuesta $30.00. Renderizar 20 borradores ($1.20) y pasar 5 ganadores a 1080p ($6.00) cuesta $7.20, un ahorro del 76%.
Una advertencia: un borrador es una generación aparte, así que trátalo como una prueba del prompt y de la idea de movimiento, no como una vista previa exacta a nivel de píxel. Comprueba si un nuevo render mantiene la misma toma antes de planificar un flujo de trabajo sobre ello.
💡 Pon un límite de reintentos estricto en tu worker: tres intentos, luego detente y registra el prompt. Un bucle que reenvía en cada fallo convierte un error de $0.30 en una factura real.
Ajusta la resolución al destino
Destino
Ajuste
Costo por 5 s
Historia vertical en redes
720p, 9:16
$0.30
Fondo principal de una web
720p, loop
$0.30
B-roll para YouTube
1080p, 16:9
$1.20
Flujo de corrección de color
1080p HDR + EXR
$3.60
Define aspect_ratio en el momento de generar en lugar de reencuadrar después, y usa la marca loop para los clips de fondo en vez de unir un loop a mano.
Ray 3.2 sin escribir código
La API encaja con un producto o con un flujo programado. Para un proyecto puntual, una interfaz de navegador elimina la gestión de tokens, el bucle de consulta y el código de límites de uso. PicassoIA aloja Ray 3.2, así que eliges los ajustes desde un formulario y descargas el MP4.
PicassoIA también tiene su propia API al estilo de Replicate. En el momento de escribir esto, expone cuatro modelos de PicassoIA, entre ellos PicassoIA Video y Seedance 2.5 Lite. Ray 3.2 no está en esa lista, así que se queda en la interfaz web.
Lo que te ofrece PicassoIA
Control
Opciones
Resolución
540p, 720p, 1080p
Duración
5s o 10s
Relación de aspecto
9:16, 3:4, 1:1, 4:3, 16:9, 21:9
HDR
720p o 1080p, solo 5s
Exportación EXR
Requiere HDR
Loop
No con 10s, HDR ni imagen final
Imagen inicial e imagen final
Solo 5s
Se aplican las mismas reglas de combinación que en la API de Luma. Una diferencia: el formulario de PicassoIA no incluye el nivel de borrador a 360p. Consulta tu plan en PicassoIA para saber cómo se cuentan las generaciones de Ray 3.2.
Escribe un prompt que indique el sujeto, el movimiento, el movimiento de cámara, la iluminación y el ritmo.
Empieza en 720p y 5 segundos mientras pruebas.
Elige una relación de aspecto o sube una imagen inicial para animar una foto.
Activa HDR o loop solo si las reglas anteriores lo permiten.
Genera, revisa el clip, ajusta el prompt y vuelve a ejecutar. Cuando el movimiento se vea bien, renderiza de nuevo a 1080p.
Un prompt que funciona bien en la página del modelo: "Slow cinematic dolly shot through a misty greenhouse at sunrise, golden sun rays filtering through condensation on vintage glass panels, lush ferns and orchids, anamorphic lens flares."
Alternativas más baratas y gratuitas
Ray 3.2 no es la única forma de conseguir movimiento cinematográfico, y a $1.20 por toma a 1080p no siempre es la más barata. Estos modelos de PicassoIA sirven para los mismos trabajos de texto a video e imagen a video:
Una división práctica: prototipa con un modelo gratuito y gasta los créditos de Ray 3.2 en las tomas que necesiten HDR, EXR o el encuadre 21:9. PicassoIA también incluye las categorías de escalado de video y superresolución en su página de todos los modelos. Vale la pena probar si un clip de Ray 3.2 a 720p, escalado, cumple tu nivel de calidad antes de pagar la tarifa 4× de 1080p nativo.
Genera tu primer clip hoy
Las cifras son sencillas cuando se ven juntas. 720p cuesta $0.30, 1080p cuesta $1.20, HDR duplica el precio, EXR lo triplica y dos clips de 5 segundos superan a uno de 10. Haz borradores a 360p, genera con la relación de aspecto que necesites y limita tus reintentos.
Abre Ray 3.2 en PicassoIA, ejecuta un prompt a 720p y luego envía exactamente el mismo prompt a Ray Flash 2 720p y Seedance 2.5 Lite. Tres clips uno al lado del otro te dirán más sobre precio frente a calidad que cualquier tabla de tarifas. Crea los tuyos ya en picassoia.com.