API de Magnific
API de Magnific
Este artículo es una traducción. La versión en inglés es la versión de referencia y la que prevalece en caso de duda.
Integra la biblioteca de contenido de stock y las herramientas con tecnología de IA de Magnific en tus propias aplicaciones
La API de Magnific permite a los desarrolladores integrar el contenido y las capacidades de IA de Magnific directamente en sus propios productos, plataformas y flujos de trabajo. En lugar de usar el sitio web de Magnific manualmente, puedes buscar recursos de stock, generar imágenes y vídeos con IA, editar contenido y mucho más mediante llamadas a la API REST estándar
La referencia técnica completa (endpoints, parámetros, detalles de autenticación, ejemplos de código y esquemas de respuesta) se encuentra en la documentación de la API en docs.magnific.com. Este artículo cubre lo esencial para ayudarte a entender qué ofrece la API y cómo empezar
En este artículo
Qué puedes hacer con la API
La API está organizada en varias áreas de servicio:
Servicio | Qué hace |
|---|---|
Contenido de stock | Busca, filtra y descarga entre más de 200 millones de recursos: vectores, fotos, iconos, archivos PSD y más |
Genera imágenes a partir de prompts de texto usando múltiples modelos de IA, incluidos Mystic, Flux y otros | |
Generación de vídeos con IA | Crea vídeos a partir de entradas de texto o imagen usando modelos de IA |
Edición de imágenes | Quita fondos, mejora imágenes con Magnific, aplica filtros y realiza otras ediciones mediante programación |
Iconos | Busca y descarga iconos con filtros de formato y estilo |
Audio | Genera efectos de sonido y contenido de audio mediante IA |
Los servicios y modelos disponibles pueden cambiar a medida que Magnific añada nuevas capacidades de IA. Consulta docs.magnific.com para ver la lista de endpoints más reciente
Primeros pasos
Cómo consumir créditos mediante API
Paso 1 — Accede a los ajustes
Abre el menú de usuario y dirígete a los ajustes de la organización. Dentro, encontrarás la sección de clave de API
Paso 2 — Crea una clave de API
Crea una nueva clave de API con un nombre identificativo. El sistema generará automáticamente:
La clave de API
El secreto de firma del webhook
Ambos se muestran una sola vez. Asegúrate de copiarlos antes de cerrar la ventana
Paso 3 — Gestiona tus claves
Puedes cambiar el nombre de cualquier clave desde el menú de acciones sin perder su secreto ni su historial de consumo
Puedes desactivar temporalmente una clave (útil para rotaciones o emergencias) sin perderla
Puedes eliminar permanentemente una clave con confirmación
Paso 4 — Auditar el uso de créditos
Puedes auditar el consumo de la bolsa de créditos filtrando por una clave de API específica para tener un control granular sobre el uso
Cuentas Enterprise: si aún no ves la sección de claves de API, contacta con tu representante de Magnific designado para solicitar acceso. Una vez habilitado, los pasos anteriores se aplican de la misma manera
Panel de control de la API (legado)
El panel de control de la API es tu centro neurálgico para gestionar todo lo relacionado con el uso de tu API. Puedes acceder a él haciendo clic en tu imagen de perfil en la esquina superior derecha y seleccionando Panel de control de la API, o yendo directamente a magnific.com/developers/dashboard
Desde el panel de control puedes:
Ver y regenerar tu clave de API
Seguir el uso y monitorizar el volumen de solicitudes en tiempo real
Establece un presupuesto mensual para controlar el gasto
Revisa los límites de tasa y los precios de cada servicio
Gestiona la información de facturación y los métodos de pago
Panel de administración de la API con modelo basado en créditos
Los usuarios de la API con suscripción pueden gestionar sus cuentas a través del panel de administración, que se encuentra dentro del panel de suscripción. Desde aquí, puedes realizar las siguientes acciones:
Precios y facturación
La API de Magnific utiliza un sistema de suscripción con un modelo basado en créditos
Herramientas de generación con IA
Cada solicitud de generación mediante API —imágenes, vídeos, audio, mejorar calidad de imagen, edición y más— descuenta créditos de tu saldo
Para usar la API, puedes elegir entre los siguientes planes de suscripción:
Premium: 1 clave de API, 20.000 créditos al mes o 240.000 créditos al año
Premium+: 1 clave de API, 45.000 créditos al mes o 600.000 créditos al año
Pro: 3 claves de API, 300.000 créditos al mes o 4.000.000 créditos al año
Business: 5 claves de API, 90.000 créditos al mes o 1.080.000 al año
Enterprise: claves de API ilimitadas, créditos anuales personalizados, escalabilidad según tu uso
Encontrarás los costes detallados en créditos para cada herramienta y generación en nuestro Centro de ayuda
Todas las suscripciones también te permiten generar contenido directamente en nuestra web
Si tu plan incluye uso «Ilimitado», ten en cuenta que esto solo se aplica dentro de la web app de Magnific; las llamadas a la API siempre consumen créditos
Descargas de contenido de stock
Planes Premium, Premium+ y Pro: las descargas de stock a través de la API no consumen créditos, pero están limitadas a 100 al día
Planes Business y Enterprise: descargas de stock ilimitadas, cada una deducida de tu saldo de créditos como cualquier otra llamada a la API
Límites de velocidad
La API aplica límites de velocidad para garantizar la estabilidad y un uso justo para todos los desarrolladores. Los límites se aplican tanto a nivel de clave de API como de dirección IP
Tipo de límite | Umbral |
|---|---|
Ráfaga por segundo | 50 solicitudes por segundo en una ventana de 5 segundos |
Tasa media | 10 solicitudes por segundo de media en una ventana de 2 minutos |
Límites diarios | Varían según el servicio. Comprueba tu panel para ver los límites específicos de RPD (solicitudes por día) e IPD (imágenes por día) |
Si superas estos límites, las solicitudes pueden ser limitadas o bloqueadas temporalmente hasta que el límite se restablezca. Si tu aplicación requiere límites más altos, contacta con el equipo de ventas para hablar sobre un plan personalizado
Reglas de uso
La API de Magnific está diseñada para su integración en productos digitales y flujos de trabajo. Para mantener activo tu acceso a la API, sigue estas reglas:
No utilices la API para minería de datos, extracción de contenido o entrenamiento de modelos de IA
No vendas ni redistribuyas contenido de Magnific sin modificaciones
Informa de las descargas con precisión: activa una solicitud de descarga cada vez que un usuario utilice un recurso de forma única. Por ejemplo, cuando alguien selecciona una imagen para una entrada de blog, la establece como cabecera o la utiliza como fondo
El almacenamiento en caché está permitido siempre que mantengas un plan activo y notifiques todas las descargas de forma precisa y rápida
Importante
El incumplimiento de estas normas supondrá la retirada inmediata del acceso a la API
Códigos de error comunes
Cuando algo falla en una solicitud, la API devuelve códigos de estado HTTP estándar. Estos son los más comunes:
Código | Significado | Qué hacer |
|---|---|---|
401 No autorizado | La clave de API no es válida o falta | Comprueba que tu clave esté incluida en la cabecera x-magnific-api-key y que tenga el formato correcto |
404 No encontrado | El endpoint o recurso no existe | Revisa la URL y los parámetros de la solicitud |
429 Demasiadas solicitudes | Límite de velocidad excedido | Espera a que el límite se restablezca, mejora tu plan o contacta con el equipo de ventas para obtener límites más altos |
500 Error interno del servidor | Problema en el lado del servidor | Reintenta la solicitud. Si el problema persiste, contacta con soporte |
Para obtener la lista completa de códigos de respuesta y sus significados, consulta la documentación de la API
Recursos y soporte
Recurso | URL |
|---|---|
Documentación completa de la API | docs.magnific.com |
Página de inicio de la API | magnific.com/api |
Panel de control de la API | magnific.com/developers/dashboard |
Entorno de pruebas de la API | magnific.com/api/playground |
Precios de la API | magnific.com/api/pricing |
Contactar con ventas | magnific.com/api#contact |
Si tienes problemas o preguntas sobre tu integración de la API, puedes contactar con el equipo de soporte a través del formulario de contacto en magnific.com/api#contact o mediante la página de soporte general