Przewodnik integracji

Zainstaluj PoYo w ComfyUI

Lokalne wizualne workflows AI

Używaj modeli obrazu, wideo i audio PoYo obok lokalnych węzłów ComfyUI, z wizualnymi połączeniami i plikami wyjściowymi.

Zanim zaczniesz

Wykonuj kroki po kolei. Każdy krok wskazuje miejsce działania i wynik, który potwierdza, że możesz iść dalej.

1
Sprawdź wersję ComfyUI
Zaktualizuj ComfyUI przed instalacją pakietu węzłów, jeśli twoja wersja jest starsza niż 0.32.0.
Kontynuuj, gdy: ComfyUI pokazuje wersję 0.32.0 lub nowszą.
2
Zainstaluj węzły i zrestartuj ComfyUI
Sklonuj oficjalne repozytorium do custom_nodes, a następnie całkowicie zrestartuj ComfyUI, aby mógł wczytać nowy pakiet.
Terminal
cd ComfyUI/custom_nodes git clone https://github.com/PoyoAPI/poyo-comfyui.git
Kontynuuj, gdy: Po wyszukaniu PoYo w menu węzłów widać zainstalowane węzły PoYo.
3
Skonfiguruj klucz API
Ustaw klucz przed uruchomieniem ComfyUI albo użyj lokalnego polecenia konfiguracji. Nie wklejaj klucza do pól węzłów workflow.
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
Alternatywa: konfiguracja lokalna
python -m poyo_nodes.configure
Kontynuuj, gdy: Węzły PoYo mogą wczytać aktualny katalog modeli bez błędu uwierzytelniania.

Użyj oficjalnego przykładu, aby przetestować instalację i poświadczenia, zanim zbudujesz większy workflow.

Zacznij od jednego małego workflow, który odpowiada zachowaniu, jakie chcesz sprawdzić.

Uruchom prosty węzeł generowania obrazów PoYo i zapisz zwrócony obraz.

Wyślij zadanie do ogólnego modelu z katalogu, poczekaj na zakończenie i zapisz plik wyniku.

Jak zaimportować

Pierwszy sukces: Kolejka kończy się, a wygenerowany wynik jest dostępny w ComfyUI/output/poyo.

Węzły PoYo się nie pojawiają: Całkowicie zrestartuj ComfyUI i sprawdź konsolę startową pod kątem błędu importu poyo_nodes.
Katalog się nie wczytuje: Sprawdź klucz API i połączenie sieciowe, a po zmianie zmiennych środowiskowych uruchom ponownie.
Workflow nie może znaleźć wyniku: Poczekaj, aż zadanie osiągnie status finished, a potem sprawdź węzeł Save Result File i ComfyUI/output/poyo.

Szczegóły techniczne

Te szczegóły są ważne w integracjach produkcyjnych, ale nie są warunkiem pierwszego udanego uruchomienia.

Poświadczenia pozostają poza wyeksportowanymi plikami workflow.
Zadania zachowują publiczne statusy not_started, running, finished i failed.
Żądania wywołują bezpośrednio aktualne endpointy REST PoYo i zawierają znacznik X-PoYo-Source.