API de Magnific

API de Magnific

Cet article est une traduction. La version anglaise fait foi et est celle qui s’applique en cas de doute.

Intégrez la bibliothèque de contenu de stock et les outils avec la technologie de l’IA de Magnific dans vos propres applications

L’API de Magnific permet aux développeurs d’intégrer le contenu et les capacités d’IA de Magnific directement dans leurs propres produits, plateformes et flux de travail. Au lieu d’utiliser le site web de Magnific manuellement, vous pouvez rechercher par programmation des ressources de stock, générer des images IA et des vidéos, modifier du contenu, et plus encore via des appels API REST standard

La référence technique complète (points de terminaison, paramètres, détails d’authentification, exemples de code et schémas de réponse) se trouve dans la documentation de l’API sur docs.magnific.com. Cet article couvre les éléments essentiels pour vous aider à comprendre ce que l’API propose et comment démarrer

Dans cet article

• Ce que vous pouvez faire avec l’API

• Démarrer

• Tableau de bord API

• Prix et facturation

• Limites de débit

• Règles d’utilisation

• Codes d’erreur courants

• Ressources et assistance

Ce que vous pouvez faire avec l’API

L’API est organisée en plusieurs domaines de service :

Les services et modèles disponibles peuvent évoluer à mesure que Magnific ajoute de nouvelles fonctionnalités d’IA. Consultez docs.magnific.com pour obtenir la liste la plus récente des points de terminaison

Bien démarrer

Comment consommer des crédits via l’API

Étape 1 — Accéder aux paramètres
Ouvrez le menu Utilisateur et rendez-vous dans les paramètres de l’organisation. À l’intérieur, vous trouverez la section Clés API

Étape 2 — Créer une clé API
Créez une nouvelle clé API avec un nom d’identification. Le système générera automatiquement :

• La clé API

• Le secret de signature du webhook

Ces deux éléments ne sont affichés qu’une seule fois. Assurez-vous de les copier avant de fermer la fenêtre

Étape 3 — Gérer vos clés

• Vous pouvez renommer n’importe quelle clé depuis le menu Actions sans perdre son secret ou son historique de consommation

• Vous pouvez désactiver temporairement une clé (utile pour une rotation ou en cas d’urgence) sans la perdre

• Vous pouvez supprimer définitivement une clé après confirmation

Étape 4 — Auditer la consommation de crédits
Vous pouvez auditer la consommation du pool de crédits en filtrant par une clé API spécifique pour un contrôle granulaire de l’utilisation

Comptes Enterprise : si vous ne voyez pas encore la section Clés API, contactez votre représentant Magnific dédié pour demander l’accès. Une fois activé, les étapes ci-dessus s’appliquent de la même manière

Tableau de bord API (ancien)

Le tableau de bord API est votre centre névralgique pour gérer tout ce qui concerne votre utilisation de l’API. Vous pouvez y accéder en cliquant sur votre photo de profil dans le coin supérieur droit et en sélectionnant Tableau de bord API, ou en vous rendant directement sur magnific.com/developers/dashboard

Depuis le tableau de bord, vous pouvez :

• Voir et régénérer votre clé API

• Suivre l’utilisation et surveiller le volume de requêtes en temps réel

• Définissez un budget mensuel pour contrôler vos dépenses

• Consultez les limites de débit et les prix pour chaque service

• Gérez les informations de facturation et les méthodes de paiement

Panneau d’administration de l’API de Magnific basé sur un modèle de crédit

Les utilisateurs de l’API avec un abonnement peuvent gérer leurs comptes via le panneau d’administration, situé dans le panneau d’abonnement. À partir de là, vous pouvez effectuer les actions suivantes :

• Créez des clés API

• Vérifiez et gérez les autorisations pour les clés API

• Contrôlez les crédits dépensés par chaque clé

Prix et facturation

L’API de Magnific utilise un système d’abonnement avec un modèle basé sur des crédits

Outils de génération par IA

Chaque requête de génération par API — images, vidéos, audio, upscaling, édition, et plus encore — déduit des crédits de votre solde

Pour utiliser l’API, vous pouvez choisir parmi les abonnements suivants :

• Premium : 1 clé API, 20 000 crédits/mois ou 240 000 crédits/an

• Plus : 1 clé API, 45 000 crédits/mois ou 600 000 crédits/an

• Pro : 3 clés API, 300 000 crédits/mois ou 4 000 000 crédits/an

• Business : 5 clés API, 90 000 crédits/mois ou 1,08 million/an

• Enterprise : clés API illimitées, crédits annuels personnalisés, mise à l’échelle selon votre utilisation

Vous trouverez le détail des coûts en crédits pour chaque outil et génération dans notre Centre d’aide

Tous les abonnements vous permettent également de générer du contenu directement sur notre site web

Si votre abonnement inclut une utilisation « Illimité », veuillez noter que cela s’applique uniquement au sein de l’application web Magnific : les appels API consomment toujours des crédits.

Téléchargements de contenu de stock

• Abonnements Premium, Plus et Pro : les téléchargements de contenu de stock via l’API ne consomment pas de crédits mais sont limités à 100 par jour.

• Abonnements Business et Enterprise : téléchargements de contenu de stock illimités, chacun étant déduit de votre solde de crédits comme n’importe quel autre appel API.

Limites de débit

L’API impose des limites de débit pour garantir la stabilité et une utilisation équitable pour tous les développeurs. Les limites s’appliquent à la fois au niveau de la clé API et de l’adresse IP.

Si vous dépassez ces limites, les requêtes peuvent être ralenties ou temporairement bloquées jusqu’à la réinitialisation de la limite. Si votre application nécessite des limites plus élevées, contactez l’équipe commerciale pour discuter d’un abonnement personnalisé

Règles d’utilisation

L’API de Magnific est conçue pour être intégrée dans des produits numériques et des flux de travail. Pour maintenir votre accès à l’API actif, respectez ces règles :

• Ne pas utiliser l’API pour l’exploration de données, le scraping de contenu ou l’entraînement de modèles d’IA

• Ne pas vendre ou redistribuer du contenu Magnific sans modification

• Signaler les téléchargements avec précision : déclenchez une requête de téléchargement chaque fois qu’une ressource est utilisée de manière unique par un utilisateur. Par exemple, lorsqu’une personne sélectionne une image pour un article de blog, la définit comme en-tête ou l’utilise comme arrière-plan

• La mise en cache est autorisée tant que vous maintenez un abonnement actif et que vous signalez tous les téléchargements de manière précise et rapide

Important

Le non-respect de ces règles entraînera la suppression immédiate de l’accès à l’API

Codes d’erreur courants

Lorsqu’une erreur survient lors d’une requête, l’API renvoie des codes d’état HTTP standard. Voici les plus courants :

Pour obtenir la liste complète des codes de réponse et leur signification, consultez la documentation de l’API

Ressources et assistance

Si vous rencontrez des problèmes ou si vous avez des questions concernant votre intégration API, vous pouvez contacter l’équipe d’assistance via le formulaire de contact sur magnific.com/api#contact ou via la page d’assistance générale