La API para desarrolladores de Freepik ahora funciona bajo el nombre Magnific. Consulta cuánto cuestan por imagen, según lo publicado, Mystic y los modelos Flux, cuánto cobra el upscaler Magnific según el tamaño de salida, los límites de frecuencia documentados y un presupuesto para 1.000 imágenes.
La API para desarrolladores de Freepik no siguió llamándose Freepik por mucho tiempo. Desde finales de abril de 2026, toda la plataforma, incluidas la biblioteca de stock y las herramientas de IA, se vende bajo el nombre Magnific, y la antigua dirección de la documentación ahora redirige a docs.magnific.com. Si estás presupuestando una API de generación de imágenes IA para un producto, el cambio de nombre importa menos que la lista de precios que hay debajo, porque tu factura tiene dos partes muy distintas: un generador de imágenes barato (Mystic más una larga lista de modelos Flux y Seedream) y un upscaler cuyo precio depende del tamaño de salida en píxeles.
Este artículo expone lo que dice la documentación, lo que informan los rastreadores de precios externos y los puntos en los que no coinciden, para que puedas estimar un costo mensual real antes de escribir una sola línea de código de integración. Lo marcado como documentado viene de la documentación oficial. Lo marcado como informado procede de fuentes externas y conviene verificarlo en tu propio panel.
Varios artículos sobre precios de 2026 fechan el cambio el 28 de abril de 2026, cuando Magnific pasó a ser la marca única para los recursos de stock y para un conjunto de herramientas de IA que abarca imagen, video, audio, 3D y diseño. Para quienes usan la API, los efectos visibles son pequeños pero reales.
docs.freepik.com responde con una redirección permanente a docs.magnific.com (documentado).api.freepik.com como api.magnific.com seguían aceptándose durante la migración (informado).💡 Consejo: Guarda el host y los nombres de las cabeceras en un mismo archivo de configuración. Así, el próximo cambio de nombre será una modificación de una línea en lugar de una búsqueda por todo tu código.
Tres endpoints hacen casi todo el trabajo en los proyectos de imagen. Todos son asíncronos: envías una tarea, recibes un task_id y un estado, y luego consultas el resultado o dejas que un webhook_url te llame de vuelta. Las tareas de Mystic pasan de CREATED a IN_PROGRESS y terminan en un estado finalizado o en FAILED (documentado).
| Tarea | Método y ruta | Notas |
|---|---|---|
| Generar con Mystic | POST /v1/ai/mystic | Texto a imagen, con referencias de estilo y estructura opcionales |
| Escalado creativo | POST /v1/ai/image-upscaler | Puede inventar detalles nuevos, guiados por un prompt |
| Escalado de precisión | POST /v1/ai/image-upscaler-precision | Conserva el contenido original, sin detalles inventados |
Una integración típica sigue los mismos cuatro pasos para los tres:
webhook_url.task_id que devuelve junto a tu registro, como un pedido o un ID de producto.
Lo primero que hay que aclarar es qué saldo paga tus llamadas. Confundirlo es un error de presupuesto fácil con esta API.
La documentación indica que cada solicitud de IA, ya sea de imagen, video, audio, escalado o edición, descuenta créditos del saldo de tu organización (documentado). Los planes para particulares son un producto distinto. Los rastreadores indican que Premium cuesta €12 al mes con facturación anual y 240.000 créditos al año, y Premium+ cuesta €27 al mes con 600.000 créditos (informado). Varios artículos describen la API como un servicio separado para desarrolladores, de prepago, así que confirma de qué saldo salen tus solicitudes antes de lanzar nada. Una forma barata de hacerlo: genera una imagen Mystic de 1K y compara el saldo antes y después. Esa sola prueba te da tu propio precio por imagen, medido en tu cuenta.
La documentación oficial publica una tabla de precios del upscaler, pero ninguna tabla de generación por modelo. Las cifras siguientes proceden de rastreadores de precios externos, así que tómalas como una estimación de partida.
| Modelo | Precio informado por imagen |
|---|---|
| Classic Fast | $0,005 |
| Flux Dev | $0,012 |
| Flux 2 Pro (1K) | $0,04 |
| Flux Kontext Pro | $0,04 |
| Flux Pro 1.1 | $0,043 |
| HyperFlux | $0,161 |
⚠️ Ojo con los valores atípicos: un artículo actualizado a finales de septiembre de 2026 todavía indica que la generación con Mystic cuesta 0,40 por cada 100 creaciones, unos 0,004 cada una. Eso es aproximadamente diez veces menos que el precio de Flux 2 Pro indicado arriba. Una diferencia de este tamaño es buen motivo para consultar la lista de precios en vivo antes de presupuestar.
Los artículos informan de unos 5 en crédito gratuito inicial (en euros en un caso y en dólares en otro) y de un tope de autoservicio de 500 al mes antes de tener que hablar con ventas (informado). Si tu plan necesita más, pide un acuerdo a medida con antelación, porque las mismas páginas indican que los límites más altos se gestionan con el equipo de ventas.
Mystic es el motor propio de Freepik para texto a imagen, y su lista de parámetros es lo bastante larga como para merecer su propia tabla.
| Parámetro | Valores | Predeterminado |
|---|---|---|
resolution | 1k, 2k, 4k | 2k |
aspect_ratio | 13 ajustes predefinidos, como widescreen_16_9, social_story_9_16, classic_4_3 | square_1_1 |
model | zen, flexible, fluid, realism, super_real, editorial_portraits | realism |
engine | automatic, magnific_illusio, magnific_sharpy, magnific_sparkle | automatic |
creative_detailing | 0 a 100 | 33 |
fixed_generation | true o false | false |
structure_reference, style_reference | Imagen en Base64 | ninguno |
filter_nsfw | true o false | true |
Dos detalles ahorran tiempo de depuración. Primero, los prompts aceptan referencias de personajes escritas como @character_name o @character_name::strength. Segundo, filter_nsfw no se puede desactivar para usuarios estándar, así que el contenido para adultos no pasa por esta API en absoluto. Por su nombre, super_real y editorial_portraits apuntan a trabajo fotográfico, mientras que zen y fluid suenan más a resultados pictóricos. Haz una pequeña tanda de prueba de cada uno antes de decidirte, con el mismo prompt en todas, para que la única variable sea el modelo.
Además de Mystic, la documentación enumera Flux Kontext Pro, Flux 2 Pro, Flux 2 Turbo, Flux 2 Klein, Flux Pro 1.1, Flux Dev, Hyperflux, Seedream 4, Seedream 4.5, Z-Image Turbo y un endpoint de texto a imagen de Runway (documentado). Esa amplitud es el verdadero atractivo: una integración y un saldo, muchos generadores.
Los nombres dan pistas sobre los usos previstos. Kontext Pro pertenece a la línea Flux Kontext, pensada para editar una imagen existente a partir de una instrucción de texto. Las variantes Turbo y Klein apuntan a velocidad y a un costo menor por imagen. Seedream 4.5 y Flux 2 Pro son opciones habituales para visuales de marketing pulidos. Como el catálogo cambia rápido, consulta la lista de modelos en vivo antes de fijar un nombre de modelo en el código, y guarda ese nombre en la configuración en lugar de en tu código fuente.
Aquí es donde la factura crece. Ambos modos admiten factores de 2x, 4x, 8x y 16x, y ambos se cobran según el área en píxeles de la salida, no según el número de llamadas (documentado).
El endpoint creativo acepta scale_factor, optimized_for, prompt, creativity, hdr, resemblance, fractality, engine y webhook_url. En la práctica se comporta como un generador guiado por tu foto: añade textura y profundidad que nunca estuvieron en el original. Eso encaja con ilustraciones, arte conceptual y fotos suaves que necesitan un realce. No es buena opción para rostros que debas mantener fieles ni para imágenes con texto, porque el detalle inventado puede alterar ambos.
La documentación recomienda enviar la imagen original por URL siempre que sea posible. Las subidas en Base64 y las exportaciones desde lienzo pierden calidad antes de que el upscaler las vea.
El modo de precisión, introducido a mediados de 2025 según las reseñas, amplía la imagen sin inventar contenido nuevo. Es la opción más segura para logotipos, capturas de interfaces, fotos de producto y escaneos. La documentación recomienda una entrada de al menos 256 a 512 píxeles en el lado más corto, PNG para gráficos, JPEG o PNG de alta calidad para fotos y factores moderados de 2x a 4x, ya que llevarlo más lejos tiende a amplificar el ruido.
Una forma rápida de elegir entre los dos modos:
| Tu imagen de origen | Modo recomendado | Motivo |
|---|---|---|
| Logotipo, icono o captura de interfaz | Precisión | Los bordes y las letras no deben cambiar |
| Foto de producto para un catálogo | Precisión | El cliente espera el artículo real |
| Escaneo antiguo o foto muy comprimida | Creativo, intensidad baja | La textura que falta tiene que salir de algún sitio |
| Ilustración o arte conceptual | Creativo | Un detalle extra es bienvenido |
| Retrato de una persona real | Precisión, o creativo con intensidad baja | El detalle inventado puede alejarse del rostro |
La documentación ofrece tres ejemplos resueltos, idénticos para ambos modos. Las columnas de megapíxeles son un añadido mío, para mostrar el patrón.
| Entrada | Salida | Factor | Costo | Tamaño de salida | Costo por megapíxel |
|---|---|---|---|---|---|
| 640×480 | 1280×960 | 2x | €0,10 | 1,23 MP | unos €0,081 |
| 1920×1080 | 3840×2160 | 2x | €0,20 | 8,29 MP | unos €0,024 |
| 640×480 | 5120×3840 | 8x | €0,50 | 19,66 MP | unos €0,025 |
Con solo tres puntos, dos cosas parecen probables (mi inferencia, no una fórmula publicada). Las salidas pequeñas parecen tener un suelo cercano a diez céntimos, y las grandes se estabilizan en torno a dos céntimos y medio por megapíxel. La lección práctica: una imagen pequeña escalada 8x cuesta más que un fotograma Full HD escalado 2x, así que decide el tamaño final en píxeles antes de elegir el factor.
Los límites documentados son generosos para la mayoría de proyectos (documentado):
Las cifras por IP importan si un grupo de workers comparte una misma dirección de salida. Diez workers que lanzan cada uno cinco solicitudes por segundo superarán con creces la media de 10 por segundo en 2 minutos. Añade una cola pequeña y un backoff exponencial cuando una solicitud sea limitada, y el límite dejará de ser visible para tus usuarios.
El límite que de verdad muerde no es una tasa. Los enlaces de salida caducan 30 minutos después de la generación, así que copia cada resultado a tu propio almacenamiento en cuanto una tarea informe que ha terminado. Prefiere los webhooks a los bucles de consulta muy seguidos, y registra cada tarea FAILED para poder reintentarla antes de que se cierre la ventana.
Imagina que una tienda online quiere 1.000 visuales de producto, cada uno generado una vez y escalado a 4K. Usando el precio de Flux 2 Pro informado y el precio del upscaler documentado:
| Paso | Precio unitario | Cantidad | Total |
|---|---|---|---|
| Generar con Flux 2 Pro en 1K | $0,04 | 1.000 | unos $40 |
| Escalar 1920×1080 a 3840×2160 | €0,20 | 1.000 | €200 |
| Escalar solo las 200 mejores | €0,20 | 200 | €40 |
Escalar cuesta unas cinco veces más que generar, así que el ahorro más barato es la selección: elige primero las ganadoras y escala solo esas. Las miniaturas pequeñas funcionan igual. Escalar 5.000 imágenes de 640×480 a 1280×960 a €0,10 cada una suma €500, lo mismo que el tope mensual de autoservicio indicado antes.
💡 Consejo: Genera con la resolución que necesitas y omite el upscaler cuando una salida en 2K ya encaje en el diseño. Cada escalado que evites es un precio unitario completo ahorrado.
Cinco hábitos mantienen la factura estable a medida que crece el volumen:
Si quieres comparar calidad antes de comprometerte con cualquier API, Picasso IA aloja alternativas cercanas para ambas mitades del flujo de trabajo, y puedes probarlas primero en el navegador.
| Modo de Magnific más cercano | Modelos de Picasso IA | Qué esperar |
|---|---|---|
| Creativo | Recraft Creative Upscale, Clarity Pro Upscaler | Más profundidad y textura, hasta 16x con Clarity Pro |
| Precisión | Recraft Crisp Upscale, Topaz Image Upscale | Ampliación fiel, hasta 6x con Topaz |
| Trabajos rápidos 4x | Real ESRGAN, Google Upscaler, Bria Increase Resolution | Ampliación rápida y predecible |
| Retratos y velocidad | Crystal Upscaler, P Image Upscale | Detalle de la piel, resultados en aproximadamente un segundo |
La correspondencia es de espíritu, no de identidad. Cada modelo tiene su propio aspecto, así que pasa la misma foto de prueba por dos o tres antes de juzgar.
Clarity Pro Upscaler es la opción más parecida al modo creativo de Magnific por su control único de creatividad. Mantiene intacta la estructura facial, los poros de la piel y los mechones de pelo mientras amplía.
scale_factor. El valor por defecto es 2. Elige 2, 4, 8 o 16 según el tamaño objetivo.creativity. El valor por defecto es 0. Los valores negativos se quedan cerca del original; los positivos añaden textura y profundidad.output_format. PNG no tiene pérdida y es el predeterminado. JPG usa una calidad del 95 % y da archivos más pequeños.💡 Consejo: Empieza en 2x con la creatividad en 0 y luego sube un ajuste cada vez. Cambiar la escala y la creatividad a la vez dificulta ver cuál provocó el cambio.
También puedes llamar a Picasso IA por programa. Su API está en https://api.picassoia.com/v1 y sigue el mismo patrón que el flujo de Freepik descrito arriba: crear una predicción, consultarla y obtener el resultado. Cuando se escribió este artículo ofrecía cuatro modelos (imagen, edición de imagen, video y video con audio) con 5 predicciones simultáneas por cuenta. La redacción de la web sobre costos y requisitos de plan no era coherente en ese momento, así que confírmalo en la página de precios antes de construir sobre ella.
Para una prueba rápida sin integrar nada, toma una foto suave y de baja resolución, pásala por Clarity Pro Upscaler a 2x y luego prueba Topaz Image Upscale con el mismo archivo. Genera una imagen nueva con Flux 2 Pro y pásala por los mismos pasos. En una tarde sabrás qué aspecto encaja con tu proyecto, y tendrás cifras reales con las que comparar la lista de precios de Magnific. Elige una foto, abre un modelo y haz tu primera prueba hoy.
Elige tu idioma
