Magnific-API

Magnific-API

Dieser Artikel ist eine Übersetzung. Die englische Version ist die Referenzversion und diejenige, die im Zweifelsfall gilt.

Integriere die Stock-Inhalte-Bibliothek und die KI-gestützten Tools von Magnific in deine eigenen Anwendungen

Die Magnific-API ermöglicht es EntwicklerInnen, die Inhalte und KI-Funktionen von Magnific direkt in ihre eigenen Produkte, Plattformen und Workflows zu integrieren. Anstatt die Magnific-Website manuell zu nutzen, kannst du programmatisch nach Stock-Ressourcen suchen, KI-Bilder und Videos generieren, Inhalte bearbeiten und vieles mehr – und das alles über standardmäßige REST-API-Aufrufe

Die vollständige technische Referenz (Endpunkte, Parameter, Authentifizierungsdetails, Codebeispiele und Antwort-Schemas) findest du in der API-Dokumentation unter docs.magnific.com. Dieser Artikel behandelt die Grundlagen, damit du verstehst, was die API bietet und wie du startest

In diesem Artikel

• Was du mit der API machen kannst

• Erste Schritte

• API-Dashboard

• Preisgestaltung und Abrechnung

• Ratenbegrenzungen

• Nutzungsregeln

• Häufige Fehlercodes

• Ressourcen und Support

Was du mit der API machen kannst

Die API ist in verschiedene Servicebereiche unterteilt:

Verfügbare Dienste und Modelle können sich ändern, während Magnific neue KI-Funktionen hinzufügt. Überprüfe docs.magnific.com für die aktuellste Endpunkt-Liste

Erste Schritte

So verbrauchst du Credits über die API

Schritt 1 – Greife auf die Einstellungen zu
Öffne das Benutzermenü und gehe zu den Organisations-Einstellungen. Dort findest du den Bereich API-Schlüssel

Schritt 2 – Erstelle einen API-Schlüssel
Erstelle einen neuen API-Schlüssel mit einem identifizierenden Namen. Das System generiert automatisch:

• Den API-Schlüssel

• Das Webhook-Signatur-Geheimnis

Beide werden nur einmal angezeigt. Stelle sicher, dass du sie kopierst, bevor du das Fenster schließt

Schritt 3 – Verwalte deine Schlüssel

• Du kannst jeden Schlüssel über das Aktionsmenü umbenennen, ohne dass sein Geheimnis oder der Verbrauch verlustig gehen

• Du kannst einen Schlüssel vorübergehend deaktivieren (nützlich für Rotation oder Notfälle), ohne ihn zu verlieren

• Du kannst einen Schlüssel nach Bestätigung dauerhaft löschen

Schritt 4 – Credit-Verbrauch prüfen
Du kannst den Verbrauch deines Credit-Pools prüfen, indem du nach einem bestimmten API-Schlüssel filterst, um eine granulare Kontrolle über die Nutzung zu erhalten

Enterprise-Konten: Falls du den Bereich für API-Schlüssel noch nicht siehst, kontaktiere deine zuständige Magnific-Kontaktperson, um Zugriff anzufordern. Sobald dieser aktiviert ist, gelten die oben genannten Schritte auf die gleiche Weise

API-Dashboard (Legacy)

Das API-Dashboard ist deine zentrale Anlaufstelle für die Verwaltung aller Aspekte deiner API-Nutzung. Du kannst darauf zugreifen, indem du oben rechts auf dein Profilbild klickst und API-Dashboard auswählst oder direkt auf magnific.com/developers/dashboard gehst

Vom Dashboard aus kannst du:

• Deinen API-Schlüssel ansehen und neu generieren

• Nutzung verfolgen und das Anfragevolumen in Echtzeit überwachen

• Lege ein monatliches Budget fest, um deine Ausgaben zu kontrollieren

• Überprüfe die Ratenbegrenzungen und die Preisgestaltung für jeden Dienst

• Verwalte deine Abrechnungs-Informationen und Zahlungsmethoden

Administrations-Panel für die API mit Credit-basiertem Modell

API-Nutzer mit einem Abo können ihre Konten über das Administrations-Panel verwalten, das sich innerhalb des Abo-Panels befindet. Von dort aus kannst du folgende Aktionen durchführen:

• API-Schlüssel erstellen

• Berechtigungen für die API-Schlüssel überprüfen und verwalten

• Die von jedem Schlüssel verbrauchten Credits kontrollieren

Preisgestaltung und Abrechnung

Die Magnific-API verwendet ein Abo-System mit einem Credit-basierten Modell

KI-Generierungstools

Jede API-Generierungsanfrage – Bilder, Videos, Audio, Upscaling, Bearbeitung und mehr – zieht Credits von deinem Guthaben ab

Um die API zu nutzen, kannst du aus den folgenden Abo-Plänen wählen:

• Premium: 1 API-Schlüssel, 20.000 Credits/Monat oder 240.000 Credits/Jahr

• Plus: 1 API-Schlüssel, 45.000 Credits/Monat oder 600.000 Credits/Jahr

• Pro: 3 API-Schlüssel, 300.000 Credits/Monat oder 4 Mio. Credits/Jahr

• Business: 5 API-Schlüssel, 90.000 Credits/Monat oder 1,08 Mio./Jahr

• Enterprise: unbegrenzte API-Schlüssel, individuelle jährliche Credits, Skalierung mit deiner Nutzung

Detaillierte Credit-Kosten für jedes Tool und jede Generierung findest du in unserem Hilfe-Center

Alle Abos ermöglichen es dir außerdem, Inhalte direkt auf unserer Website zu generieren

Falls dein Plan eine „Unbegrenzt“-Nutzung beinhaltet, beachte bitte, dass dies nur innerhalb der Magnific-Web-App gilt – API-Aufrufe verbrauchen immer Credits.

Downloads von Stock-Inhalten

• Premium-, Plus- und Pro-Pläne: Stock-Downloads über die API verbrauchen keine Credits, sind jedoch auf 100 pro Tag begrenzt.

• Business- und Enterprise-Pläne: unbegrenzte Stock-Downloads, die jeweils wie jeder andere API-Aufruf von deinem Credit-Guthaben abgezogen werden.

Ratenbegrenzungen

Die API erzwingt Ratenbegrenzungen, um Stabilität und eine faire Nutzung für alle EntwicklerInnen zu gewährleisten. Die Begrenzungen gelten sowohl auf Ebene des API-Schlüssels als auch der IP-Adresse.

Wenn du diese Limits überschreitest, können Anfragen gedrosselt oder vorübergehend blockiert werden, bis das Limit zurückgesetzt wird. Wenn deine Anwendung höhere Limits erfordert, kontaktiere das Sales-Team, um einen individuellen Plan zu besprechen

Nutzungsregeln

Die Magnific-API ist für die Integration in digitale Produkte und Workflows konzipiert. Um deinen API-Zugriff aktiv zu halten, befolge diese Regeln:

• Verwende die API nicht für Data Mining, Content-Scraping oder das Training von KI-Modellen

• Verkaufe oder verbreite Magnific-Inhalte nicht ohne vorherige Bearbeitung

• Downloads korrekt melden: Löse jedes Mal eine Download-Anfrage aus, wenn eine Ressource von einer Person eindeutig verwendet wird. Zum Beispiel, wenn jemand ein Bild für einen Blogbeitrag auswählt, es als Header festlegt oder es als Hintergrund verwendet

• Caching ist erlaubt, solange du einen aktiven Plan unterhältst und alle Downloads genau und zeitnah meldest

Wichtig

Ein Verstoß gegen diese Regeln führt zum sofortigen Entzug des API-Zugriffs

Häufige Fehlercodes

Wenn bei einer Anfrage etwas schiefgeht, gibt die API standardmäßige HTTP-Statuscodes zurück. Hier sind die häufigsten:

Die vollständige Liste der Antwortcodes und ihre Bedeutung findest du in der API-Dokumentation

Ressourcen und Support

Falls du auf Probleme stößt oder Fragen zu deiner API-Integration hast, kannst du das Support-Team über das Kontaktformular unter magnific.com/api#contact oder über die allgemeine Support-Seite erreichen