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). Authentifiziere dich, indem du deinen Schlüssel im Header „Authorization: Bearer imk_…“ sendest. In Claude Code genügt ein Befehl: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer dein-schluessel". In Claude.ai oder Cursor fügst du einen eigenen Connector mit derselben Adresse und demselben Header hinzu.
Vier Werkzeuge stehen bereit. list_models liefert den Katalog und die Preise in Credits. generate_image erstellt ein Bild und wartet auf das Ergebnis: die URL kommt direkt zurück. generate_video startet ein Video und liefert eine Verfolgungs-Id. get_generation_status folgt einer Generierung bis zur finalen URL.
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.