L’API développeur de Freepik fonctionne désormais sous le nom Magnific. Découvrez ce que coûtent, d’après les informations disponibles, Mystic et les modèles Flux par image, ce que facture l’upscaler Magnific selon la taille de sortie, les limites de requêtes documentées et un budget pour 1 000 images.
L’API développeur de Freepik n’est pas restée Freepik longtemps. Depuis fin avril 2026, toute la plateforme, bibliothèque de photos et outils d’IA compris, se vend sous le nom Magnific, et l’ancienne adresse de la documentation redirige désormais vers docs.magnific.com. Si vous budgétez une API de génération d’images par IA pour un produit, le changement de nom compte moins que la grille tarifaire en dessous, car votre facture comporte deux parties très différentes : un générateur d’images bon marché (Mystic et une longue liste de modèles Flux et Seedream) et un upscaler dont le prix suit la taille de la sortie en pixels.
Cet article présente ce que disent la documentation, ce que rapportent les sites de suivi tiers, et les points où les deux divergent, afin que vous puissiez estimer un coût mensuel réel avant d’écrire la moindre ligne de code d’intégration. Tout ce qui est marqué documenté provient de la documentation officielle. Tout ce qui est marqué rapporté provient de sources externes et mérite une vérification dans votre propre tableau de bord.
Plusieurs articles sur les tarifs de 2026 datent le changement du 28 avril 2026, date à laquelle Magnific est devenu la marque unique pour les ressources de banques d’images et pour une suite d’IA couvrant l’image, la vidéo, l’audio, la 3D et le design. Pour les utilisateurs de l’API, les effets visibles sont petits mais réels.
docs.freepik.com répond par une redirection permanente vers docs.magnific.com (documenté).api.freepik.com et api.magnific.com étaient encore acceptés pendant la migration (rapporté).💡 Astuce : Regroupez le nom de l’hôte et celui de l’en-tête dans un seul fichier de configuration. Le prochain renommage ne demandera alors qu’une modification d’une ligne, au lieu d’une recherche dans toute votre base de code.
Trois points d’accès font presque tout le travail pour les projets d’images. Tous sont asynchrones : vous soumettez une tâche, recevez un task_id et un statut, puis vous interrogez le résultat ou laissez un webhook_url vous rappeler. Les tâches Mystic passent de CREATED à IN_PROGRESS et se terminent soit dans un état finalisé, soit dans FAILED (documenté).
| Tâche | Méthode et chemin | Remarques |
|---|---|---|
| Générer avec Mystic | POST /v1/ai/mystic | Texte vers image, avec références de style et de structure facultatives |
| Upscaling créatif | POST /v1/ai/image-upscaler | Peut inventer de nouveaux détails, guidés par un prompt |
| Upscaling de précision | POST /v1/ai/image-upscaler-precision | Conserve le contenu d’origine, sans détail inventé |
Une intégration typique suit les mêmes quatre étapes pour les trois :
webhook_url.task_id renvoyé à côté de votre propre enregistrement, comme une commande ou un identifiant produit.
La première chose à régler est le solde qui paie vos appels. Confondre les deux est une erreur de budget facile avec cette API.
La documentation indique que chaque requête d’IA, qu’il s’agisse d’image, de vidéo, d’audio, d’upscaling ou d’édition, débite des crédits du solde de votre organisation (documenté). Les forfaits grand public sont un produit différent. Les sites de suivi indiquent Premium à 12 € par mois en facturation annuelle avec 240 000 crédits par an, et Premium+ à 27 € par mois avec 600 000 crédits (rapporté). Plusieurs articles décrivent l’API comme un service développeur distinct et prépayé ; vérifiez donc quel solde vos requêtes utilisent avant de mettre en production. Une méthode simple : lancez une génération Mystic en 1K, puis comparez le solde avant et après. Ce seul test vous donne votre propre prix par image, mesuré sur votre compte.
La documentation officielle publie un tableau de prix pour l’upscaler, mais aucun tableau par modèle pour la génération. Les chiffres ci-dessous proviennent de sites tiers de suivi des prix ; traitez-les donc comme une estimation de départ.
| Modèle | Prix rapporté par image |
|---|---|
| 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 $ |
⚠️ Attention aux valeurs aberrantes : un article mis à jour fin septembre 2026 indique encore un tarif de génération Mystic de 0,40 pour 100 créations, soit environ 0,004 par création. C’est à peu près dix fois moins que le prix de Flux 2 Pro indiqué plus haut. Un écart de cette ampleur est une bonne raison de consulter la liste de prix en vigueur avant de budgéter.
Les articles rapportent un crédit de départ gratuit d’environ 5 (en euros dans l’un, en dollars dans l’autre) et un plafond en libre-service de 500 par mois avant de devoir contacter le service commercial (rapporté). Si votre projet en demande davantage, demandez tôt un accord sur mesure, car les mêmes pages indiquent que les limites plus élevées passent par l’équipe commerciale.
Mystic est le moteur texte vers image maison de Freepik, et sa liste de paramètres est assez longue pour mériter son propre tableau.
| Paramètre | Valeurs | Valeur par défaut |
|---|---|---|
resolution | 1k, 2k, 4k | 2k |
aspect_ratio | 13 préréglages comme 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 à 100 | 33 |
fixed_generation | true ou false | false |
structure_reference, style_reference | Image en Base64 | aucune |
filter_nsfw | true ou false | true |
Deux détails font gagner du temps au débogage. D’abord, les prompts acceptent des références de personnages écrites @character_name ou @character_name::strength. Ensuite, filter_nsfw ne peut pas être désactivé pour les utilisateurs standard, donc le contenu pour adultes ne passera pas du tout par cette API. D’après leur nom, super_real et editorial_portraits visent des productions photographiques, tandis que zen et fluid semblent plus proches d’un rendu pictural. Lancez un petit lot de test pour chacun avant de vous engager, avec le même prompt à chaque fois, afin que la seule variable soit le modèle.
Au-delà de Mystic, la documentation liste 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 ainsi qu’un point d’accès texte vers image de Runway (documenté). Cette diversité est le véritable argument de vente : une seule intégration et un seul solde, de nombreux générateurs.
Les noms suggèrent les usages visés. Kontext Pro appartient à la famille Flux Kontext, conçue pour modifier une image existante à partir d’une instruction textuelle. Les variantes Turbo et Klein laissent penser à plus de rapidité et à un coût par image plus bas. Seedream 4.5 et Flux 2 Pro sont des choix fréquents pour des visuels marketing soignés. Comme le catalogue évolue vite, consultez la liste de modèles en vigueur avant de coder en dur un nom de modèle, et gardez ce nom dans la configuration plutôt que dans votre code source.
C’est avec l’upscaling que la facture grimpe. Les deux modes prennent en charge les facteurs 2x, 4x, 8x et 16x, et tous deux sont facturés selon la surface en pixels de la sortie, et non selon le nombre d’appels (documenté).
Le point d’accès créatif accepte scale_factor, optimized_for, prompt, creativity, hdr, resemblance, fractality, engine et webhook_url. En pratique, il se comporte comme un générateur guidé par votre photo : il ajoute de la texture et de la profondeur qui ne figuraient pas dans la source. Cela convient à l’illustration, au concept art et aux photos douces qui ont besoin d’un coup de peps. En revanche, il est mal adapté aux visages que vous devez conserver fidèlement, ou à toute image contenant du texte, car les détails inventés peuvent altérer les deux.
La documentation conseille d’envoyer l’image d’origine par URL chaque fois que c’est possible. Les importations en Base64 et les exports de canevas perdent de la qualité avant même que l’upscaler ne les voie.
Le mode précision, introduit mi-2025 selon les critiques, agrandit l’image sans générer de contenu inventé. C’est le choix le plus sûr pour les logos, les captures d’écran d’interface, les photos de produits et les numérisations. La documentation recommande une entrée d’au moins 256 à 512 pixels sur le petit côté, du PNG pour les graphismes, du JPEG ou PNG de haute qualité pour les photos, et des facteurs modérés de 2x à 4x, car aller plus loin tend à amplifier le bruit.
Une façon rapide de choisir entre les deux modes :
| Votre image source | Mode le plus adapté | Raison |
|---|---|---|
| Logo, icône ou capture d’écran d’interface | Précision | Les contours et les lettres ne doivent pas changer |
| Photo de produit pour un catalogue | Précision | Le client attend l’article réel |
| Vieux scan ou photo fortement compressée | Créatif, faible intensité | La texture manquante doit venir de quelque part |
| Illustration ou concept art | Créatif | Les détails supplémentaires sont bienvenus |
| Portrait d’une vraie personne | Précision, ou créatif à faible intensité | Un détail inventé peut s’écarter du visage |
La documentation donne trois exemples chiffrés, identiques pour les deux modes. Les colonnes en mégapixels sont de mon ajout, pour montrer la tendance.
| Entrée | Sortie | Facteur | Coût | Taille de sortie | Coût par mégapixel |
|---|---|---|---|---|---|
| 640×480 | 1280×960 | 2x | 0,10 € | 1,23 MP | environ 0,081 € |
| 1920×1080 | 3840×2160 | 2x | 0,20 € | 8,29 MP | environ 0,024 € |
| 640×480 | 5120×3840 | 8x | 0,50 € | 19,66 MP | environ 0,025 € |
À partir de seulement trois points, deux choses semblent probables (mon inférence, pas une formule publiée). Les petites sorties semblent avoir un plancher proche de dix centimes, et les grandes se stabilisent autour de 2,5 centimes par mégapixel. En pratique, retenez ceci : une image minuscule agrandie en 8x coûte plus cher qu’une image Full HD agrandie en 2x, donc décidez de la taille finale en pixels avant de choisir un facteur.
Les limites documentées sont généreuses pour la plupart des projets (documenté) :
Les chiffres par IP comptent si une flotte de workers partage une même adresse de sortie. Dix workers qui envoient chacun cinq requêtes par seconde dépasseront largement la moyenne de 10 par seconde sur 2 minutes. Ajoutez une petite file d’attente et une temporisation exponentielle lorsqu’une requête est limitée, et la limite devient invisible pour vos utilisateurs.
La limite qui pose vraiment problème n’est pas une cadence. Les liens de sortie expirent 30 minutes après la génération, donc copiez chaque résultat dans votre propre stockage dès qu’une tâche signale qu’elle est terminée. Privilégiez les webhooks aux boucles d’interrogation rapprochées, et journalisez chaque tâche FAILED afin de pouvoir la relancer avant la fin de la fenêtre.
Imaginons qu’une boutique en ligne veuille 1 000 visuels de produits, chacun généré une fois puis agrandi en 4K. En utilisant le prix rapporté de Flux 2 Pro et le prix documenté de l’upscaler :
| Étape | Prix unitaire | Nombre | Total |
|---|---|---|---|
| Générer avec Flux 2 Pro en 1K | 0,04 $ | 1 000 | environ 40 $ |
| Upscaler de 1920×1080 à 3840×2160 | 0,20 € | 1 000 | 200 € |
| Upscaler seulement les 200 meilleures | 0,20 € | 200 | 40 € |
L’upscaling coûte environ cinq fois plus cher que la génération, donc l’économie la plus simple consiste à faire une sélection : choisissez d’abord les gagnantes et n’upscalez que celles-là. Les petites miniatures suivent la même logique. Upscaler 5 000 images de 640×480 à 1280×960 à 0,10 € chacune donne 500 €, ce qui correspond au plafond mensuel en libre-service indiqué plus haut.
💡 Astuce : Générez à la résolution dont vous avez besoin, et évitez l’upscaler lorsqu’une sortie en 2K suffit déjà pour la mise en page. Chaque upscaling évité représente un prix unitaire complet économisé.
Cinq habitudes permettent de garder une facture stable à mesure que le volume augmente :
Si vous voulez comparer la qualité avant de vous engager sur une API, Picasso IA propose des alternatives proches pour les deux moitiés du flux de travail, que vous pouvez tester d’abord dans un navigateur.
| Mode Magnific le plus proche | Modèles Picasso IA | À quoi s’attendre |
|---|---|---|
| Créatif | Recraft Creative Upscale, Clarity Pro Upscaler | Profondeur et texture ajoutées, jusqu’à 16x avec Clarity Pro |
| Précision | Recraft Crisp Upscale, Topaz Image Upscale | Agrandissement fidèle, jusqu’à 6x avec Topaz |
| Traitements rapides en 4x | Real ESRGAN, Google Upscaler, Bria Increase Resolution | Agrandissement rapide et prévisible |
| Portraits et rapidité | Crystal Upscaler, P Image Upscale | Détail de la peau, résultats en environ une seconde |
Ce rapprochement relève de l’esprit, non de l’identité. Chaque modèle a son propre rendu : testez la même photo sur deux ou trois modèles avant de juger.
Clarity Pro Upscaler est le plus proche du mode créatif de Magnific grâce à son unique réglage de créativité. Il conserve intacts la structure du visage, les pores de la peau et les mèches de cheveux pendant l’agrandissement.
scale_factor. La valeur par défaut est 2. Choisissez 2, 4, 8 ou 16 selon la taille visée.creativity. La valeur par défaut est 0. Les valeurs négatives restent proches de l’original, les valeurs positives ajoutent de la texture et de la profondeur.output_format. Le PNG est sans perte et constitue la valeur par défaut. Le JPG utilise une qualité de 95 % et donne des fichiers plus légers.💡 Astuce : Commencez à 2x avec une créativité à 0, puis modifiez un seul réglage à la fois. Changer l’échelle et la créativité en même temps rend difficile l’identification de ce qui a provoqué un changement.
Les développeurs peuvent aussi appeler Picasso IA par programmation. Son API se trouve à https://api.picassoia.com/v1 et suit le même schéma que le flux Freepik décrit plus haut : créer une prédiction, l’interroger, récupérer le résultat. Au moment de la rédaction de cet article, elle proposait quatre modèles (image, édition d’image, vidéo et vidéo avec audio) avec 5 prédictions simultanées par compte. La formulation du site sur le coût et les exigences de forfait n’était pas cohérente à ce moment-là ; vérifiez-la donc sur la page tarifs avant de construire quoi que ce soit dessus.
Pour un test rapide sans aucune intégration, prenez une photo douce et de basse résolution, passez-la dans Clarity Pro Upscaler en 2x, puis essayez Topaz Image Upscale sur le même fichier. Générez une nouvelle image avec Flux 2 Pro et faites-la passer par les mêmes étapes. En une demi-journée, vous saurez quel rendu convient à votre projet, et vous disposerez de chiffres réels à comparer avec la liste de prix Magnific. Choisissez une photo, ouvrez un modèle et lancez votre premier test dès aujourd’hui.
Choisissez votre langue
