Asynchrone KI-Bilderzeugung mit Replicate-Polling-Schleife - n8n-Workflow

Benutzer, die asynchrone KI-Aufgaben automatisieren müssen, bei denen Ergebnisse nicht sofort zurückgegeben werden.
Entwickler, die eine zuverlässige n8n-Vorlage für die Integration langlaufender API-Dienste wie Replicate suchen.
Technische Vermarkter oder Designer, die KI-Modelle (insbesondere das Modell creativeathive/lemaar-door-mockedup) zur Inhaltserstellung nutzen.
Jeder, der Expertenbeispiele für n8n-Workflows sucht, welche die grundlegende Ablaufsteuerung demonstrieren.

Die Erzeugung komplexer KI-Bilder dauert oft eine Weile, was bedeutet, dass die anfängliche API-Anfrage nur eine Vorhersage-ID (Prediction ID) und nicht das Endergebnis liefert. Dies erfordert ein wiederholtes „Polling“ des Dienstes, bis der Auftrag abgeschlossen ist. Dieser spezialisierte n8n-Workflow löst dieses Problem durch die Implementierung einer robusten, selbstkorrigierenden Polling-Schleife.

Die Automatisierung startet mit einem n8n-Trigger, initialisiert den Auftrag bei Replicate und tritt dann mithilfe der n8n-Nodes Wait und If in eine Schleife ein. Diese Schleife stellt sicher, dass der Workflow pausiert (Wait-Node), den Status überprüft (HTTP Request n8n-Node) und nur dann fortfährt, wenn der Status auf „succeeded“ (erfolgreich) gesetzt ist. Diese leistungsstarke Logik macht diese n8n-Vorlage hochgradig zuverlässig für die Handhabung externer asynchroner Aufgaben – ein entscheidendes Muster für fortgeschrittene n8n-Automatisierungen.

Dieser n8n-Workflow wird über eine strukturierte Sequenz ausgeführt, die speziell für asynchrone API-Interaktionen konzipiert ist:

1. Manuelle Auslösung: Der Workflow beginnt mit dem n8n-Trigger „On clicking 'execute'“ (Bei Klick auf „Ausführen“), was das manuelle Testen und Starten des Prozesses ermöglicht.


2. API-Schlüssel-Setup: Der n8n-Node „Set API Key“ (API-Schlüssel festlegen) initialisiert den erforderlichen Replicate API-Schlüssel und stellt so die sichere Authentifizierung für die nachfolgenden Schritte sicher.


3. Vorhersage erstellen: Ein HTTP Request n8n-Node sendet eine POST-Anfrage an die Replicate API, um den KI-Generierungsprozess unter Verwendung des spezifizierten Modells (creativeathive/lemaar-door-mockedup) und der Eingabeparameter (Prompt, Seed usw.) zu starten.


4. ID extrahieren: Der n8n-Node „Extract Prediction ID“ (Vorhersage-ID extrahieren) verarbeitet sofort die API-Antwort, extrahiert die eindeutige Vorhersage-ID und konstruiert die erforderliche URL für das Polling.


5. Polling initiieren: Der Workflow wechselt zum n8n-Node „Wait“ (Warten), der die Ausführung für 2 Sekunden pausiert, um die API während des Polling-Zyklus nicht zu überlasten.


6. Status prüfen: Der HTTP Request n8n-Node „Check Prediction Status“ (Vorhersagestatus prüfen) fragt nun mithilfe der extrahierten URL und des API-Schlüssels den Status des KI-Generierungsauftrags ab.


7. Schleifensteuerung: Der If n8n-Node „Check If Complete“ (Prüfen, ob abgeschlossen) analysiert den Status. Wenn der Status „succeeded“ lautet, fährt der Workflow mit der Verarbeitung des Ergebnisses fort. Ist der Status ein anderer (z. B. „processing“, „starting“), wird der Workflow zurück zum „Wait“-Node geleitet, um die 2-sekündige Pause und die anschließende Statusprüfung neu zu starten. Diese Polling-Logik ist ein Kernmerkmal des n8n-Workflows.


8. Ergebnis verarbeiten: Sobald der Auftrag abgeschlossen ist, extrahiert der n8n-Node „Process Result“ (Ergebnis verarbeiten) die endgültigen Ausgabedaten, einschließlich der URL des generierten Bildes, der Abschlussmetriken und anderer relevanter Metadaten.

Um diesen umfassenden n8n-Workflow bereitzustellen, gehen Sie wie folgt vor:

1. n8n-Workflow importieren: Kopieren Sie den bereitgestellten JSON-Code und importieren Sie ihn direkt in Ihre n8n-Instanz über den Bereich „Workflows“ mithilfe der Schaltfläche „Import from JSON“ (Aus JSON importieren).


2. Replicate-Anmeldedaten einrichten: Sie benötigen einen Replicate API-Schlüssel. Besorgen Sie sich diesen Schlüssel in den Kontoeinstellungen Ihres Replicate-Kontos.


3. API-Key-Node konfigurieren: Suchen Sie den n8n-Node „Set API Key“ im importierten Workflow. Ersetzen Sie im Konfigurationsbereich für die Zuweisung von replicateapikey den Platzhalterwert YOURREPLICATEAPI_KEY durch Ihren tatsächlichen Replicate API-Schlüssel.


4. Eingabe-Prompt konfigurieren: Suchen Sie den n8n-Node „Create Prediction“ (Vorhersage erstellen). Bearbeiten Sie den JSON-Body, um Ihren gewünschten Wert für prompt festzulegen, und passen Sie Eingaben wie seed, width und height bei Bedarf für das Modell an.


5. Aktivieren und Testen: Aktivieren Sie den n8n-Workflow und klicken Sie auf die Schaltfläche „Execute Workflow“ (Workflow ausführen), um die vollständige asynchrone Polling-Sequenz zu testen.

Dieser n8n-Workflow nutzt mehrere Schlüssel-n8n-Knotentypen, um seine komplexe Logik zu verwalten:

On clicking 'execute' (Manueller Trigger n8n trigger): Der Startpunkt dieser spezifischen n8n-Workflow-Vorlage, der die manuelle Initiierung des Prozesses erlaubt.
Set API Key (Set n8n node): Wird verwendet, um den erforderlichen Replicate API-Schlüssel sicher in den Workflow-Datenstrom einzuspeisen und so die Authentifizierung für nachfolgende HTTP-Anfragen zu ermöglichen.
Create Prediction (HTTP Request n8n node): Verantwortlich für den Aufruf der Replicate API, um den asynchronen Bildgenerierungsauftrag zu starten. Er sendet den Eingabe-Prompt und die Modellkonfiguration.
Extract Prediction ID (Code n8n node): Ein entscheidender benutzerdefinierter n8n-Code-Node, der die für den Polling-Prozess benötigte eindeutige ID extrahiert und die Endpunkt-URL für Statusabfragen generiert.
Wait (Wait n8n node): Implementiert die notwendige Zeitverzögerung (2 Sekunden) innerhalb der Polling-Schleife, um sicherzustellen, dass der Workflow die externe API nicht überlastet und dem Prozess Zeit zur Abarbeitung gibt.
Check Prediction Status (HTTP Request n8n node): Das Herzstück des Polling-Mechanismus. Dieser n8n-Node fragt wiederholt den Status des Replicate-Dienstes basierend auf der Vorhersage-ID ab.
Check If Complete (If n8n node): Stellt die Ablaufsteuerung für den n8n-Workflow bereit. Er prüft, ob der Status gleich „succeeded“ ist. Wenn ja, verlässt der Workflow die Schleife; wenn nein, wird er zurück zum Wait-Node geleitet.
Process Result (Code n8n node): Wird nach Abschluss ausgeführt, bereinigt die Daten und präsentiert die endgültige Bild-URL sowie Metadaten zur Weiterverarbeitung.