Alle Integrationen

Integrationsleitfaden

Installieren Sie PoYo für ComfyUI

Lokale visuelle KI-Workflows

Verwenden Sie PoYo Bild-, Video- und Audiomodelle neben lokalen ComfyUI-Knoten mit visuellen Verbindungen und Dateiausgaben.

Bevor Sie beginnen

  • ComfyUI 0.32.0 oder neuer
  • Git und ein PoYo API Schlüssel

Drei Schritte zu einem verifizierten Setup

Führen Sie die Schritte der Reihe nach aus. Zu jedem Schritt gehört der Handlungsort und das Ergebnis, das bestätigt, dass Sie fortfahren können.

  1. 1

    Überprüfen Sie Ihre ComfyUI-Version

    Aktualisieren Sie ComfyUI, bevor Sie das Node Pack installieren, wenn Ihre Version älter als 0.32.0 ist.

    Fahren Sie fort, wenn: ComfyUI meldet Version 0.32.0 oder neuer.
  2. 2

    Installieren Sie die Knoten und starten Sie ComfyUI neu.

    Klonen Sie das offizielle Repository in custom_nodes und starten Sie dann ComfyUI vollständig neu, damit das neue Paket geladen werden kann.

    Terminal
    cd ComfyUI/custom_nodes
    git clone https://github.com/PoyoAPI/poyo-comfyui.git
    Fahren Sie fort, wenn: Wenn Sie im Knotenmenü nach PoYo suchen, werden die installierten PoYo-Knoten angezeigt.
  3. 3

    Konfigurieren Sie den Schlüssel API

    Legen Sie den Schlüssel fest, bevor Sie ComfyUI starten, oder verwenden Sie den lokalen Konfigurationsbefehl. Fügen Sie den Schlüssel nicht in Workflow-Knotenfelder ein.

    Windows
    set POYO_API_KEY=your_poyo_api_key
    set POYO_BASE_URL=https://api.poyo.ai
    macOS / Linux
    export POYO_API_KEY=your_poyo_api_key
    export POYO_BASE_URL=https://api.poyo.ai
    Lokale Konfigurationsalternative
    python -m poyo_nodes.configure
    Fahren Sie fort, wenn: PoYo-Knoten können den Live-Modellkatalog ohne Authentifizierungsfehler laden.

Führen Sie Ihren ersten PoYo-Workflow aus

Verwenden Sie das offizielle Beispiel, damit Installation und Anmeldeinformationen getestet werden, bevor Sie einen größeren Workflow erstellen.

Wählen Sie einen Beispielworkflow

Beginnen Sie mit einem kleinen Workflow, der dem Verhalten entspricht, das Sie überprüfen möchten.

So importieren Sie
  1. 1Laden Sie die Datei JSON herunter.
  2. 2Ziehen Sie es auf die Leinwand ComfyUI oder wählen Sie Workflow → Öffnen.
  3. 3Wählen Sie ein Modell aus, bestätigen Sie die Eingaben und wählen Sie dann Queue Prompt.
  1. 1Laden Sie einen offiziellen Beispielworkflow aus dem Repository herunter.
  2. 2Öffnen Sie es in ComfyUI und wählen Sie ein Modell aus dem Live-Katalog aus.
  3. 3Stellen Sie die Eingabeaufforderung in die Warteschlange und warten Sie, bis die Aufgabe PoYo abgeschlossen ist.
  4. 4Finden Sie das gespeicherte Ergebnis unter ComfyUI/output/poyo.

Erster Erfolg: Die Warteschlange wird abgeschlossen und ein generiertes Ergebnis ist in ComfyUI/output/poyo verfügbar.

Wenn etwas nicht funktioniert

PoYo Knoten werden nicht angezeigt
Starten Sie ComfyUI vollständig neu und überprüfen Sie die Startkonsole auf einen poyo_nodes-Importfehler.
Der Katalog wird nicht geladen
Überprüfen Sie den Schlüssel API und die Netzwerkverbindung und starten Sie dann neu, nachdem Sie die Umgebungsvariablen geändert haben.
Der Workflow kann keine Ausgabe finden
Warten Sie, bis die Aufgabe finished erreicht, und überprüfen Sie dann die Knoten Save Result File und ComfyUI/output/poyo.
Technische Details

Diese Details sind für Produktionsintegrationen wichtig, aber keine Voraussetzung für den ersten erfolgreichen Lauf.

  • Credentials bleiben außerhalb exportierter Workflowdateien.
  • Aufgaben behalten die öffentlichen Status not_started, running, finished und failed.
  • Anfragen rufen die aktuellen Endpunkte PoYo REST direkt auf und enthalten ein X-PoYo-Source-Tag.