Węzły ComfyUI

Pakiet węzłów SpicyAPI dla ComfyUI zamienia każdy model obrazu, wideo i dźwięku SpicyAPI w węzeł ComfyUI: jest ich ponad 180, a do tego węzeł SpicyAPI Chat dla modeli tekstowych i węzeł SpicyAPI LoRA. Modele działają na serwerach SpicyAPI, więc potrzebujesz połączenia z internetem i klucza API, a nie karty graficznej ani pobranych wag. Każdy węzeł pokazuje cenę, zanim ruszy, a po zakończeniu wypisuje koszt uruchomienia.

Pakiet jest bezpłatny i ma otwarty kod (MIT): github.com/spicyapi-ai/comfyui-spicyapi. Poza samym ComfyUI niczego nie instaluje.

Czy to właściwe narzędzie?

Wszystkie korzystają z tego samego konta, salda, modeli i cen.

Zanim zaczniesz

• Aktualne ComfyUI. Węzły używają API węzłów V3 z ComfyUI i były testowane z ComfyUI 0.39. Działa każda instalacja, która ładuje foldery z custom_nodes: aplikacja desktopowa, wersja przenośna albo instalacja ręczna.
• Klucz API. Utworzysz go w konsoli; zaczyna się od sk-spicy-. Jeśli nie masz jeszcze konta, zobacz Przygotuj konto.
• Saldo. Każde uruchomienie jest opłacane z przedpłaconego salda w USD. Zobacz Rozliczenia.
• Dostęp do api.spicyapi.ai z komputera, na którym działa ComfyUI. Serwer proxy ustawiony przez HTTPS_PROXY jest respektowany.

Instalacja

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Dodaj klucz API

Otwórz Settings > SpicyAPI > API key i wklej klucz. Komunikat potwierdzi, że klucz działa, i pokaże dostępne saldo. Potem zrestartuj ComfyUI jeszcze raz: lista węzłów powstaje z aktualnego katalogu twojego konta przy starcie ComfyUI, a dopóki klucz nie jest ustawiony, używana jest lista dołączona do wydania.

Klucz trafia do pliku w folderze użytkownika ComfyUI (user/spicyapi/config.json), który może odczytać tylko twoje konto. Nigdy nie jest zapisywany w pliku przepływu ani w metadanych obrazu zapisanego przez ComfyUI, więc udostępnienie któregokolwiek z nich nie ujawnia klucza. Pole w ustawieniach pokazuje potem tylko ostatnie cztery znaki. Aby usunąć klucz, wyczyść to pole.

Na serwerze albo w kontenerze ustaw zamiast tego zmienną środowiskową SPICY_API_KEY. Ma pierwszeństwo przed polem w ustawieniach.

Uruchom pierwszy węzeł

Wolisz zacząć od działającego schematu? Przeglądarka szablonów ComfyUI wymienia przykłady z pakietu w sekcji comfyui-spicyapi: tekst na obraz, obraz na wideo, model czatu piszący prompt dla modelu obrazu, zamiana tekstu na mowę oraz LoRA.

Przykłady z prawdziwymi wynikami, cenami i czasami uruchomienia oraz aktualną listę węzłów bez cenzury znajdziesz na stronie ComfyUI w serwisie spicyapi.ai.

Jak działają węzły

Każdy węzeł powstaje z opublikowanego schematu wejścia swojego modelu, tego samego, z którym API sprawdza żądania, więc węzeł nigdy nie oferuje opcji, które model by odrzucił.

Lista rozwijana ustawiona na model default albo liczba ustawiona na -1 jest pomijana w żądaniu, więc model użyje własnej wartości domyślnej.

Wyjścia to zwykłe wartości ComfyUI, więc przyjmie je każdy inny węzeł:

• Modele obrazu zwracają IMAGE. Usuwanie tła zwraca dodatkowo maskę alpha.
• Modele wideo zwracają VIDEO, a gdy włączone jest return_last_frame, także ostatnią klatkę klipu jako IMAGE.
• Modele dźwięku zwracają AUDIO. Model, który zwraca kilka klipów, na przykład Suno, oddaje je jako jedną partię, a Save Audio zapisuje każdy do osobnego pliku.
• Transkrypcja zwraca STRING.
• Każdy węzeł zwraca też swój task_id, przydatny w logach konsoli albo w zgłoszeniu do wsparcia.

Węzły Chat i LoRA

SpicyAPI Chat wysyła prompt, opcjonalne instrukcje systemowe i opcjonalne obrazy do dowolnego modelu tekstowego w SpicyAPI i zwraca odpowiedź jako STRING. Podłącz go do pola prompt węzła obrazu albo wideo, aby model językowy pisał lub poprawiał prompty wewnątrz schematu. Model, który nie czyta obrazów, odrzuca takie dane wejściowe i nic nie jest pobierane.

SpicyAPI LoRA dodaje jeden plik wag LoRA, podany jako bezpośredni link do pliku .safetensors, z siłą od 0 do 4. Połącz kilka w łańcuch, aby je nałożyć, a ostatni podłącz do wejścia loras węzła modelu LoRA (ich nazwy kończą się na LoRA). Link musi otwierać się bez logowania.

Ile kosztuje uruchomienie

• Plakietka na każdym węźle pokazuje aktualną stawkę modelu dla wybranych opcji, na przykład $0.0525/s dla wideo albo $0.01/image, i zmienia się razem z opcjami.
• Każde uruchomienie jest najpierw wyceniane. W Settings > SpicyAPI > Max cost per run ustaw limit w dolarach amerykańskich. Uruchomienie wycenione powyżej niego zatrzymuje się, zanim cokolwiek zostanie pobrane.
• Ostateczna kwota pojawia się w węźle po zakończeniu uruchomienia. Nieudane uruchomienia nie są płatne, z wyjątkiem modeli, których strona wskazuje, że odmowy są rozliczane. Zobacz Rozliczenia.
• Ziarna zaczynają od fixed. Ponowne zakolejkowanie tego samego schematu używa pierwszego wyniku zamiast płacić drugi raz. Przełącz control after generate na randomize, aby przy każdym uruchomieniu dostawać nowy wynik i nową opłatę.
• Anulowanie przerywa czekanie, nie zadanie. Uruchomienie anulowane w ComfyUI trwa dalej w SpicyAPI, jest płatne, jeśli się powiedzie, a jego wynik znajdziesz w logach konsoli.

Wyniki zostają w twojej konsoli do 14 dni albo krócej, jeśli twoje konto przechowuje je krócej. Aby mieć własną kopię, użyj węzłów Save z ComfyUI. Zobacz Przechowywanie i usuwanie danych.

Rozwiązywanie problemów

Błędy ze SpicyAPI kończą się wartością request_id albo identyfikatorem zadania. Podaj ją wsparciu, a zgłoszenie da się dokładnie odnaleźć. Kody błędów opisano w Błędy.