API und MCP-Server
Generiere aus Claude, Cursor oder eigenen Skripten mit einem API-Schlüssel: dieselben Modelle, dieselben Credits, Fehlschläge erstattet.
Imaginode jenseits des Canvas
Alles, was der Canvas generieren kann, ist auch außerhalb verfügbar: eine REST-API und ein MCP-Server (Model Context Protocol) lassen einen KI-Agenten oder ein Skript Bilder und Videos mit deinem Konto erstellen. Die Aufrufe verbrauchen die Credits deines Guthabens, zu denselben Preisen wie der Canvas, und eine fehlgeschlagene Generierung wird wie immer automatisch erstattet.
MCP ist der Standard, mit dem KI-Assistenten (Claude, Cursor und viele andere) externe Werkzeuge nutzen. Ist Imaginode verbunden, kann dein Assistent mitten im Gespräch ein Bild generieren, einen Artikel illustrieren, den er gerade schreibt, oder die Visuals eines automatisierten Workflows produzieren.
Einen API-Schlüssel erstellen
Öffne dein Profil, Abschnitt „API-Schlüssel“. Gib dem Schlüssel einen Namen („Claude Code“, „Blog-Skript“…) und erstelle ihn: das Geheimnis imk_… wird nur ein einziges Mal angezeigt, kopiere es sofort. Höchstens fünf aktive Schlüssel, jederzeit mit einem Klick widerrufbar; ein widerrufener Schlüssel funktioniert sofort nicht mehr.
Die Erstellung verlangt eine bestätigte E-Mail-Adresse, und jeder Schlüssel ist auf 10 Generierungen pro Minute begrenzt: genug für echtes Arbeiten, zu wenig, um ein Guthaben aus Versehen zu leeren, wenn ein Agent durchdreht.
Den MCP-Server verbinden
Die Adresse des Servers ist https://imaginode.ai/api/mcp (Streamable-HTTP-Transport). Zwei Wege zur Verbindung. Mit deinem Konto: In ChatGPT oder Claude fügst du einen Connector mit dieser Adresse hinzu, eine Imaginode-Seite öffnet sich, du meldest dich an und erlaubst die App (OAuth, kein Schlüssel zum Einfügen; die Seite ChatGPT und Claude beschreibt jeden Assistenten). Mit API-Schlüssel: Sende deinen Schlüssel im Header „Authorization: Bearer imk_…“, so machen es Cursor und Skripte. In Claude Code genügt ein Befehl: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp, die Anmeldung mit dem Konto öffnet sich beim ersten Gebrauch im Browser; mit --header "Authorization: Bearer dein-schluessel" nutzt du stattdessen einen Schlüssel. Mit dem Konto verbundene Apps trennst du in deinem Profil unter Verbundene Apps.
Vierzehn Tools werden bereitgestellt. list_models liefert den Katalog, was jedes Modell kann und seinen Preis in Credits; get_balance liest Ihr Guthaben, um zu prüfen, ob eine Generierung gedeckt ist, bevor sie gestartet wird. list_templates und get_template beschreiben die Canvas-Vorlagen: Modelle, Anweisungen, Verkabelung, Beispiele, und den Link, der sie startbereit öffnet. generate_image erstellt ein Bild und wartet auf das Ergebnis: die URL wird direkt zurückgegeben. generate_video startet ein Video (Startbild, Endbild, Referenzbilder) und liefert eine Tracking-ID zurück. generate_speech liest einen Text oder einen Dialog mit einer Stimme aus dem Katalog oder einer Ihrer geklonten Stimmen vor, generate_sound erzeugt einen Soundeffekt oder ein Musikstück, enhance_audio bereinigt, isoliert oder trennt eine Audiodatei. edit_image skaliert hoch, stellt frei oder verwandelt ein Foto in ein 3D-Objekt; edit_video skaliert hoch, stellt frei, verlängert, lippensynchronisiert eine Stimme oder übertragt eine Bewegung. list_voices und list_characters lesen Ihre Stimmen und Ihre Figuren, get_generation_status verfolgt eine Generierung bis zur finalen URL. Der Server spricht die Revision 2026-07-28 des Protokolls ebenso wie die Handshake-Revisionen von 2025: heutige Clients und die von morgen verbinden sich ohne jede Einstellung.
Die direkte REST-API
Für deine Skripte reichen drei Endpunkte. GET /api/models listet die Modelle, ihre Optionen und Preise, ohne Authentifizierung. POST /api/generate startet eine Generierung: ein JSON mit model, prompt und den Optionen des Modells (duration, resolution, aspectRatio, audio, imageUrls), der Schlüssel im Authorization-Header, und die Antwort enthält requestId, cost und dein neues Guthaben. GET /api/generate/status?requestId=… liefert running, dann completed mit den Ausgabe-URLs, oder failed mit der Erstattung.
Eingabebilder (imageUrls) müssen Medien sein, die auf deinem Imaginode-Konto liegen: importiere sie zuerst in deine Medien, oder verwende die URL einer früheren Generierung.
Gute Praxis
Beginne mit einem günstigen Modell (Flux Schnell, 1 Credit), um deine Prompts zu validieren, bevor du zu Premium-Modellen wechselst. Beim Video fragst du den Status alle 30 Sekunden ab: rechne mit 1 bis 5 Minuten, bei langen Generierungen bis zu 30. Die exakten Kosten kommen schon beim Start zurück, noch vor dem Ergebnis.
Ein Schlüssel ist ein Geheimnis: committe ihn nicht in ein Repository und teile ihn nicht. Beim geringsten Zweifel widerrufst du ihn im Profil und erstellst einen neuen.