Magnific Video Upscaler API : tarifs et fonctionnement

Upscaler une vidéo coûte cher d’une façon que l’upscaling d’images ne l’est jamais. Un clip de 60 secondes à 24 images par seconde représente 1 440 images distinctes, et chacune est facturée. Ce seul fait explique presque tout le fonctionnement de la tarification du Magnific video upscaler API, et pourquoi un test rapide sur un clip court paraît bon marché alors qu’un gros lot ne l’est pas. Cet article détaille le fonctionnement de l’API, l’effet de chaque paramètre sur vos séquences, ce que représentent les tarifs par image au total, et ce qu’il faut utiliser lorsqu’une intégration API demande plus d’efforts que la tâche n’en vaut la peine.

Ce que fait l’upscaler vidéo Magnific

Magnific a débuté comme un upscaler d’images par IA espagnol, devenu populaire pour ajouter des détails inventés à des images floues et basse résolution. Freepik l’a racheté en 2024, et l’entreprise fait désormais fonctionner ses outils d’IA sous le nom Magnific, avec une documentation pour développeurs sur docs.magnific.com. L’upscaler vidéo applique la même idée aux séquences animées : vous envoyez un clip, choisissez une résolution cible allant jusqu’à 4K, et récupérez un fichier plus net avec des détails reconstruits.

Il s’agit d’un service hébergé et asynchrone. Vous ne faites jamais tourner un modèle vous-même. Vous soumettez une tâche, vous attendez, puis vous récupérez une URL. Cela facilite son intégration dans une application, une file de rendu ou un outil d’automatisation, mais cela signifie aussi que toutes les décisions de qualité passent par une poignée de paramètres numériques.

Mode créatif face au mode précision

Magnific propose deux variantes d’upscaling vidéo, et choisir la bonne compte davantage que n’importe quel curseur.

L’upscaler créatif peut inventer de la texture, ce qui aide lorsque la source est floue. L’upscaler de précision ramène le résultat vers l’original grâce à son réglage strength, si bien que les visages, les logos et les motifs fins restent plus proches de ce qui a été filmé. La page de présentation mentionne aussi un endpoint turbo distinct pour un traitement plus rapide, et les limites de requêtes sont partagées entre les endpoints standard et turbo.

À qui cela sert vraiment

• Studios de restauration qui remettent à niveau des bandes anciennes et des clips de premiers téléphones pour les écrans modernes
• Équipes produit qui veulent des vidéos de démonstration en 4K à partir d’enregistrements d’écran en 1080p
• Développeurs qui intègrent l’upscaling dans une application réagissant aux webhooks
• Agences qui font passer chaque semaine des dizaines de clips pour les réseaux sociaux avec les mêmes réglages

Si vous ne correspondez à aucun de ces groupes, passez directement à la section sur les cas où l’API est superflue.

Le fonctionnement de l’API étape par étape

Le déroulement tient en trois gestes : créer une tâche, attendre, récupérer le résultat. Rien n’est diffusé en flux continu, et rien ne bloque pendant que l’upscaling s’exécute.

Authentification et première requête

Chaque appel transmet un identifiant d’API unique dans un en-tête de requête personnalisé. Le nom exact de l’en-tête est indiqué en haut de chaque page d’endpoint dans la documentation : copiez-le à partir de là plutôt que de le deviner. Le seul champ obligatoire du corps est video, une URL HTTPS accessible publiquement qui pointe directement vers le fichier.

{
  "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"
}

Copier le prompt

Un appel réussi renvoie 200 avec une petite enveloppe :

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

Copier le prompt

Les échecs renvoient 400 pour les problèmes de validation, 401 pour un identifiant absent ou invalide, et 500 ou 503 lorsque le service lui-même rencontre des difficultés.

Interrogation et webhooks

Vous disposez de deux moyens pour savoir qu’une tâche est terminée. Interrogez GET /v1/ai/video-upscaler/{task-id} jusqu’à ce que le statut change, ou transmettez un webhook_url et laissez Magnific vous appeler. Une tâche passe de CREATED à IN_PROGRESS et se termine par FAILED ou par un état de réussite final, moment où le tableau generated contient les URL des résultats. Un GET sur /v1/ai/video-upscaler liste vos tâches, ce qui est pratique après un plantage, lorsque vous devez retrouver des tâches que vous avez perdues de vue.

💡 Astuce : Enregistrez le task_id dès que vous le recevez, et copiez immédiatement les fichiers terminés dans votre propre stockage. Considérez les URL renvoyées comme temporaires tant que la documentation ne promet pas le contraire.

Pour une poignée de clips, interroger avec un délai croissant suffit. Pour les lots, les webhooks vous évitent une boucle et beaucoup de requêtes inutiles.

Règles de saisie qui piègent les utilisateurs

• L’URL doit être en HTTPS et publique. Si vous utilisez un lien pré-signé, assurez-vous qu’il reste valide assez longtemps pour que Magnific puisse récupérer le fichier.
• La documentation ne publie pas de limites de durée, de taille de fichier ni de format de conteneur : testez donc votre clip le plus long et le plus lourd avant de bâtir un pipeline autour du service.
• Une source mal compressée limite toujours le résultat. L’upscaling peut inventer de la texture, mais il ne peut pas restituer un visage que l’encodeur a déjà estompé.

Chaque paramètre expliqué simplement

Neuf réglages façonnent le résultat. La plupart ont pour valeur par défaut zéro ou sont désactivés, ce qui signifie qu’une requête nue donne un résultat propre et prudent en 2K.

Créativité, netteté et grain intelligent

Créativité est le curseur qui distingue un upscaling fidèle d’une image repeinte. À 0, le modèle reste prudent. Des valeurs plus élevées ajoutent de la texture, ce qui met en valeur les paysages et les tissus, mais peut modifier les visages. Un point de départ raisonnable se situe entre 0 et 25 pour les personnes, et davantage pour les décors ou les images anciennes qui ont peu de détails.

Netteté doit rester faible. Poussée trop loin, elle produit des halos autour des contours, qui paraissent pires que le flou qu’elle a remplacé. Grain intelligent ajoute du grain de film par-dessus, et une petite quantité (disons 5 à 10) est un moyen peu coûteux de masquer l’aspect plastique que les upscalings très propres présentent parfois.

Saveur et boost FPS

Saveur propose deux options. Considérez vivid comme le rendu le plus percutant et natural comme le plus sobre, puis lancez les deux sur le même clip de trois secondes avant de vous engager sur un lot entier.

Boost FPS augmente la fréquence d’images pour un mouvement plus fluide, avec une conséquence sur la facturation expliquée plus bas. Sur l’endpoint de précision, la documentation indique que strength est ignoré lorsque fps_boost est activé, et que l’upscaling complet est appliqué.

Sortie H.264 ou ProRes

Le h264 par défaut renvoie un MP4 classique. Choisissez prores_422_hq lorsque le fichier est destiné à une timeline d’étalonnage ou de montage : vous recevez un aperçu H.264 ainsi qu’un fichier ProRes 422 HQ .mov. Les fichiers ProRes sont volumineux, prévoyez donc l’espace de stockage et le temps de transfert avant de l’activer pour un long clip.

Le coût réel de l’upscaling

La documentation de Magnific décrit une tarification par image qui varie selon la résolution de sortie, et renvoie vers la page tarifaire pour les chiffres. Les tarifs par image les plus clairs disponibles publiquement proviennent de la page de tarification de l’API de Runway, qui répertorie l’upscaler vidéo créatif de Magnific. Utilisez-les comme point de repère et vérifiez-les sur la page de Magnific avant de vous engager sur un budget.

Calcul de la tarification par image

La formule est simple : coût = images x tarif, où les images égalent les images par seconde multipliées par la durée en secondes.

Runway convertit les dollars en crédits à raison d’un cent par crédit et arrondit au supérieur, avec un minimum d’un crédit par génération. Observez la forme de la courbe : le 4K coûte environ 33 % de plus par image que le 2K, et environ 71 % de plus que le 720p. Le passage du 720p au 4K n’est pas spectaculaire par image, mais sur des milliers d’images, cela s’additionne.

Trois exemples chiffrés

À l’échelle d’un lot : 100 clips de 15 secondes à 30 fps représentent 45 000 images, soit 405 $ en 2K ou 540 $ en 4K. C’est le chiffre à vérifier avant d’automatiser quoi que ce soit.

Multiplicateurs cachés à surveiller

• Le boost FPS modifie le nombre d’images de sortie, donc la facture suit le nouveau nombre plutôt que celui de votre entrée.
• Sur l’endpoint de précision, la documentation indique que les comptes B2B voient le nombre d’images facturées dans un en-tête de réponse X-Frames-Billed, avec un minimum de 12 images et un multiplicateur de 1,60x lorsque fps_boost est actif.
• La résolution par défaut est le 2K, donc une requête sans resolution est facturée au tarif 2K même si vous n’aviez besoin que du 720p.

💡 Astuce : Passez chaque nouvelle source dans un clip test de 3 à 5 secondes à la résolution que vous comptez livrer. Cela coûte quelques centimes et vous montre le rendu réel avant la vraie facture.

Limites de requêtes et planification de production

Le débit est la deuxième contrainte après le prix. Selon la documentation, l’offre gratuite autorise 10 requêtes par jour et le Tier 1 en autorise 125 par jour, partagées entre les endpoints standard et turbo. Au-delà, cela se négocie directement avec Magnific.

Ces chiffres façonnent votre planification bien plus que le prix. Avec le Tier 1, un lot de 100 clips tient dans une seule journée, tandis que 500 clips demandent quatre jours, sauf si votre limite est relevée. Un pipeline robuste accomplit généralement cinq tâches :

1. Enregistrer chaque task_id dans une base de données avant toute autre action
2. Soumettre les clips jusqu’à la limite quotidienne de requêtes et mettre le reste en file d’attente
3. Utiliser les webhooks pour les résultats, avec une interrogation lente en filet de sécurité
4. Relancer les tâches FAILED après un délai, et plafonner le nombre de relances
5. Journaliser les images facturées par tâche afin que les factures puissent être rapprochées

Quand l’API est superflue

L’API est le bon outil lorsque l’upscaling fait partie des fonctionnalités de votre produit ou d’un travail récurrent. C’est le mauvais outil pour un seul clip un mardi après-midi.

Le coût de mise en place est le poste caché. Héberger la source à une adresse HTTPS publique, gérer les échecs et stocker les résultats peut prendre plus de temps que l’upscaling lui-même sur un petit travail.

Comment utiliser l’upscaling vidéo sur PicassoIA

Pour les clips isolés, Video Upscale sur PicassoIA fonctionne dans le navigateur, sans identifiants, sans hébergement public et sans interrogation. Il demande trois éléments : video (obligatoire), target_resolution (720p, 1080p ou 4k, par défaut 4k) et target_fps (de 15 à 120, par défaut 30).

Réglages étape par étape

1. Ouvrez la page du modèle Video Upscale et importez votre clip.
2. Réglez target_resolution. Choisissez 4k pour les images d’archive et les grands écrans, ou 1080p lorsque le clip est destiné aux flux des réseaux sociaux.
3. Réglez target_fps. Gardez-le égal à la source pour une simple amélioration de la netteté, ou faites passer les séquences de 30 fps à 60 fps pour une action plus fluide.
4. Lancez le modèle et téléchargez le résultat sans filigrane.
5. Comparez une image du résultat avec l’original en plein écran avant de publier.

Le modèle reconstruit les détails fins au lieu d’étirer les pixels et interpole les images dans le même passage, si bien qu’une seule exécution gère à la fois la résolution et la fluidité du mouvement.

Runway Upscale v1 pour les clips courts

Upscale v1 de Runway accepte une seule entrée et agrandit le clip 4x, jusqu’au 4K. Ses limites sont claires : les vidéos doivent durer moins de 40 secondes, faire moins de 4096 pixels par côté et peser moins de 16 Mo. Cela convient bien aux reels, aux promos et aux démos, y compris aux clips générés avec Veo 3.1 ou Seedance 2.0. Pour les images fixes, Topaz Image Upscale gère les agrandissements jusqu’à 6x.

Il s’agit de moteurs différents de ceux de Magnific : les résultats ne correspondront donc pas image par image. Passez le même clip dans chacun et jugez avec vos propres yeux.

Essayez sur vos propres séquences

Le meilleur test ne coûte rien : prenez le clip le plus flou de votre disque, passez-le dans Video Upscale sur PicassoIA en 4k, et placez le résultat à côté de l’original sur un lecteur en plein écran. Si la différence vous convainc, faites-en une habitude. Si vous avez besoin du clip dans un pipeline d’application, vous saurez exactement ce qu’il faut demander à l’API.

Parcourez le catalogue complet sur picassoia.com/en/all-models, essayez les deux upscalers sur un clip qui compte pour vous, et voyez combien de vos anciennes séquences que vous pensiez perdues peuvent revenir.