API de Magnific para escalado de video: precios y cómo funciona

Escalar un video es caro de una manera en la que escalar una imagen nunca lo es. Un clip de 60 segundos a 24 fotogramas por segundo son 1.440 imágenes separadas, y cada una se factura. Ese solo hecho explica casi todo sobre cómo se cobra la API de escalado de video de Magnific, y por qué una prueba rápida con un clip corto parece barata mientras que un trabajo grande por lotes no lo parece. Este artículo repasa cómo funciona la API, qué hace cada parámetro con tu material, a cuánto ascienden las tarifas por fotograma y qué usar cuando una integración con API es más trabajo del que merece la tarea.

Qué hace el upscaler de video de Magnific

Magnific empezó como un upscaler de imágenes con IA de origen español que se hizo popular por añadir detalles inventados a fotos suaves y de baja resolución. Freepik adquirió la empresa en 2024, y hoy ejecuta sus herramientas de IA bajo el nombre Magnific, con la documentación para desarrolladores en docs.magnific.com. El upscaler de video aplica la misma idea al material en movimiento: envías un clip, eliges una resolución de destino de hasta 4K y recibes un archivo más nítido con detalle reconstruido.

Es un servicio alojado y asíncrono. Tú nunca ejecutas el modelo por tu cuenta. Envías una tarea, esperas y recoges una URL. Eso facilita conectarlo a una aplicación, a una cola de render o a una herramienta de automatización, y también significa que todas las decisiones de calidad se toman mediante un puñado de parámetros numéricos.

Modos creativo y de precisión

Magnific ofrece dos variantes de escalado de video, y elegir la adecuada importa más que cualquier control deslizante.

El upscaler creativo puede inventar textura, lo que ayuda cuando el origen está borroso. El upscaler de precisión mezcla el resultado con el original mediante su ajuste strength, así que los rostros, los logotipos y los patrones finos se mantienen más cerca de lo que se grabó. La página de resumen también enumera una ruta turbo aparte para un procesamiento más rápido, y los límites de peticiones se comparten entre los endpoints estándar y turbo.

Quién lo necesita de verdad

• Estudios de restauración que llevan cintas antiguas y clips de los primeros teléfonos a las pantallas actuales
• Equipos de producto que quieren videos de demostración en 4K a partir de grabaciones de pantalla en 1080p
• Desarrolladores que integran el escalado en una aplicación que responde a webhooks
• Agencias que pasan decenas de clips para redes sociales por los mismos ajustes cada semana

Si no encajas en ninguno de esos grupos, salta a la sección sobre cuándo la API es excesiva.

Cómo funciona la API paso a paso

Todo el flujo son tres movimientos: crear una tarea, esperar a que termine y recuperar el resultado. No se transmite nada y nada se bloquea mientras se ejecuta el escalado.

Autenticación y primera petición

Cada llamada lleva una única credencial de API en una cabecera personalizada. El nombre exacto de la cabecera aparece al principio de cada página de endpoint en la documentación, así que cópialo de ahí en lugar de adivinarlo. El único campo obligatorio en el cuerpo es video, una URL HTTPS de acceso público que apunta directamente al archivo.

{
  "video": "https://example.com/clips/harbour-720p.mp4",
  "resolution": "4k",
  "creativity": 20,
  "sharpen": 15,
  "smart_grain": 5,
  "flavor": "natural",
  "fps_boost": false,
  "output_format": "h264",
  "webhook_url": "https://example.com/hooks/upscale-finished"
}

Copiar prompt

Una llamada correcta devuelve 200 con un sobre pequeño:

{
  "data": {
    "task_id": "00000000-0000-0000-0000-000000000000",
    "status": "CREATED",
    "generated": []
  }
}

Copiar prompt

Los fallos devuelven 400 por problemas de validación, 401 si la credencial falta o no es válida, y 500 o 503 cuando el servicio en sí tiene problemas.

Sondeo y webhooks

Tienes dos formas de saber que una tarea ha terminado. Consulta GET /v1/ai/video-upscaler/{task-id} hasta que cambie el estado, o pasa un webhook_url y deja que Magnific te llame. Una tarea pasa de CREATED a IN_PROGRESS y termina en FAILED o en un estado final de éxito, momento en el que el array generated contiene las URL de salida. Un GET sobre /v1/ai/video-upscaler lista tus tareas, lo cual resulta útil tras un fallo, cuando necesitas localizar tareas que perdiste de vista.

💡 Consejo: Guarda el task_id en cuanto lo recibas, y copia los archivos terminados a tu propio almacenamiento de inmediato. Trata las URL devueltas como temporales hasta que la documentación indique lo contrario.

Para un puñado de clips, el sondeo con una espera creciente es suficiente. Para los lotes, los webhooks te ahorran un bucle y muchas peticiones desperdiciadas.

Reglas de entrada que suelen confundir

• La URL debe ser HTTPS y pública. Si usas un enlace prefirmado, asegúrate de que siga siendo válido el tiempo suficiente para que Magnific descargue el archivo.
• La documentación no publica límites de duración, tamaño de archivo ni formato de contenedor, así que prueba tu clip más largo y más pesado antes de construir un pipeline alrededor del servicio.
• Un origen mal comprimido limita el resultado. El escalado puede inventar textura, pero no puede recuperar un rostro que el codificador ya emborronó.

Cada parámetro explicado en lenguaje sencillo

Nueve ajustes dan forma a la salida. La mayoría tienen por defecto cero o desactivado, lo que significa que una petición sin más opciones da un resultado limpio y conservador en 2K.

Creatividad, nitidez y grano inteligente

Creatividad es el control que separa un escalado fiel de uno repintado. En 0 el modelo se mantiene cauto. Los valores más altos añaden textura, lo que favorece a los paisajes y a las telas, pero puede alterar los rostros. Un punto de partida razonable está entre 0 y 25 para personas, y más alto para escenarios o material antiguo con poco detalle.

Nitidez debe mantenerse baja. Si se fuerza demasiado, produce halos alrededor de los bordes que se ven peor que el desenfoque que sustituyeron. Grano inteligente añade grano de película por encima, y una cantidad pequeña (digamos de 5 a 10) es una forma barata de disimular el aspecto plástico que a veces tienen los escalados muy limpios.

Estilo y aumento de FPS

Estilo tiene dos opciones. Trata vivid como el aspecto más contundente y natural como el más contenido, y luego ejecuta ambos sobre el mismo clip de tres segundos antes de comprometer un lote completo.

Aumento de FPS eleva la frecuencia de fotogramas para un movimiento más suave, y tiene una consecuencia en la facturación que se explica más abajo. En el endpoint de precisión, la documentación indica que strength se ignora cuando fps_boost está activado, y se aplica el escalado completo.

Salida H.264 o ProRes

El valor por defecto h264 devuelve un MP4 normal. Elige prores_422_hq cuando el archivo vaya a una línea de tiempo de corrección o edición: recibes una vista previa en H.264 más un .mov en ProRes 422 HQ. Los archivos ProRes son grandes, así que calcula el almacenamiento y el tiempo de transferencia antes de activarlo para un clip largo.

El costo real de escalar

La documentación de Magnific describe una facturación por fotograma que varía según la resolución de salida, y remite a la página de precios para las cifras. Las tarifas por fotograma públicas más claras proceden de la página de precios de la API de Runway, que incluye el escalador creativo de video de Magnific. Úsalas como punto de referencia y confirma los datos en la página propia de Magnific antes de comprometer un presupuesto.

Cálculo de la facturación por fotograma

La fórmula es sencilla: costo = fotogramas x tarifa, donde los fotogramas equivalen a los fotogramas por segundo multiplicados por la duración en segundos.

Runway convierte dólares en créditos a un centavo por crédito y redondea hacia arriba, con un mínimo de un crédito por generación. Fíjate en la forma de la curva: 4K cuesta alrededor de un 33 % más por fotograma que 2K y alrededor de un 71 % más que 720p. El salto de 720p a 4K no es dramático por fotograma, pero en miles de fotogramas se acumula.

Tres ejemplos resueltos

Llevado a un lote: 100 clips de 15 segundos a 30 fps son 45,000 fotogramas, lo que suma $405 en 2K o $540 en 4K. Esa es la cifra que conviene comprobar antes de automatizar nada.

Multiplicadores ocultos a vigilar

• El aumento de FPS cambia el número de fotogramas de salida, así que la factura sigue el nuevo recuento y no tu entrada.
• En el endpoint de precisión, la documentación dice que las cuentas B2B ven el recuento de fotogramas facturados en una cabecera de respuesta X-Frames-Billed, con un mínimo de 12 fotogramas y un multiplicador de 1.60x cuando fps_boost está activo.
• La resolución por defecto es 2K, así que una petición sin resolution se factura a la tarifa de 2K aunque solo necesitaras 720p.

💡 Consejo: Pasa cada origen nuevo por un clip de prueba de 3 a 5 segundos en la resolución con la que pretendes entregar. Cuesta centavos y te muestra el aspecto real antes de la factura real.

Límites de peticiones y planificación de producción

El rendimiento es la segunda restricción después del precio. Según la documentación, el nivel gratuito permite 10 peticiones al día y el Tier 1 permite 125 peticiones al día, compartidas entre los endpoints estándar y turbo. Cualquier cifra superior se negocia directamente con Magnific.

Estas cifras moldean tu plan más que el precio. Con el Tier 1, un lote de 100 clips cabe en un solo día, mientras que 500 clips necesitan cuatro días a menos que tu límite aumente. Un pipeline sólido suele hacer cinco cosas:

1. Guarda cada task_id en una base de datos antes de hacer nada más
2. Envía clips hasta el límite diario de peticiones y pone en cola el resto
3. Usa webhooks para los resultados, con un trabajo de sondeo lento como red de seguridad
4. Reintenta las tareas FAILED con una espera y limita el número de reintentos
5. Registra los fotogramas facturados por tarea para poder conciliar las facturas

Cuándo la API es excesiva

La API es la herramienta adecuada cuando el escalado es una función de tu producto o un trabajo que se repite. No lo es para un solo clip un martes por la tarde.

El costo de la configuración es la partida oculta. Alojar el origen en una dirección HTTPS pública, gestionar los fallos y almacenar los resultados puede tardar más que el escalado en sí en un trabajo pequeño.

Cómo usar el escalado de video en PicassoIA

Para clips sueltos, Video Upscale en PicassoIA funciona en el navegador sin credenciales, sin alojamiento público y sin sondeo. Tiene tres entradas: video (obligatorio), target_resolution (720p, 1080p o 4k, por defecto 4k) y target_fps (de 15 a 120, por defecto 30).

Ajustes paso a paso

1. Abre la página del modelo Video Upscale y sube tu clip.
2. Configura target_resolution. Elige 4k para material de archivo y pantallas grandes, o 1080p si el clip va a redes sociales.
3. Configura target_fps. Déjalo igual que el origen para una mejora de nitidez pura, o sube el material de 30 fps a 60 para una acción más fluida.
4. Ejecuta el modelo y descarga el resultado sin marca de agua.
5. Compara un fotograma de la salida con el original a pantalla completa antes de publicar.

El modelo reconstruye el detalle fino en lugar de estirar píxeles e interpola los fotogramas en la misma pasada, así que una sola ejecución resuelve tanto la resolución como la suavidad del movimiento.

Runway Upscale v1 para clips cortos

Upscale v1 de Runway acepta una sola entrada y amplía el clip 4x, hasta 4K. Sus límites son claros: los videos deben durar menos de 40 segundos, tener menos de 4096 píxeles por lado y pesar menos de 16 MB. Encaja bien con reels, promos y demos, incluidos los clips generados con Veo 3.1 o Seedance 2.0. Para fotogramas fijos, Topaz Image Upscale gestiona ampliaciones de hasta 6x.

Estos son motores distintos de Magnific, así que los resultados no coincidirán fotograma a fotograma. Ejecuta el mismo clip en cada uno y juzga con tus propios ojos.

Pruébalo con tu propio material

La mejor prueba no cuesta nada: toma el clip más suave de tu disco, pásalo por Video Upscale en Picasso IA a 4k y pon el resultado junto al original en un reproductor a pantalla completa. Si la diferencia te convence, conviértelo en un hábito. Si necesitas el clip en un pipeline de aplicación, sabrás exactamente qué pedirle a la API.

Explora el catálogo completo en picassoia.com/en/all-models, prueba ambos escaladores con un clip que te importe y comprueba cuánto del material antiguo que dabas por perdido puede volver.