Nodi ComfyUI

Il pacchetto di nodi SpicyAPI per ComfyUI trasforma ogni modello di immagini, video e audio di SpicyAPI in un nodo di ComfyUI: più di 180, oltre a un nodo SpicyAPI Chat per i modelli di testo e a un nodo SpicyAPI LoRA. I modelli girano sui server di SpicyAPI, quindi ti servono una connessione a internet e una chiave API, non una scheda grafica né pesi da scaricare. Ogni nodo mostra il prezzo prima dell’esecuzione e, al termine, stampa quanto è costata.

Il pacchetto è gratuito e open source (MIT) su github.com/spicyapi-ai/comfyui-spicyapi. Non installa nulla oltre a ComfyUI stesso.

È lo strumento giusto per te?

Tutti usano lo stesso account, lo stesso saldo, gli stessi modelli e gli stessi prezzi.

Prima di cominciare

• Una versione recente di ComfyUI. I nodi usano l’API dei nodi V3 di ComfyUI e sono stati provati con ComfyUI 0.39. Va bene qualsiasi installazione che carichi le cartelle da custom_nodes: l’app desktop, la versione portatile o un’installazione manuale.
• Una chiave API. Creala nella console; inizia con sk-spicy-. Se non hai ancora un account, vedi Configura il tuo account.
• Un saldo. Ogni esecuzione viene pagata con il tuo saldo prepagato in dollari statunitensi. Vedi Fatturazione.
• Accesso a api.spicyapi.ai dalla macchina su cui gira ComfyUI. Un proxy impostato tramite HTTPS_PROXY viene rispettato.

Installazione

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

Aggiungi la tua chiave API

Apri Settings > SpicyAPI > API key e incolla la chiave. Un avviso conferma che la chiave funziona e mostra il saldo disponibile. Poi riavvia ComfyUI una volta: l’elenco dei nodi viene costruito dal catalogo aggiornato del tuo account all’avvio di ComfyUI, e finché non è impostata una chiave si usa l’elenco incluso nella versione.

La chiave viene salvata in un file nella cartella utente di ComfyUI (user/spicyapi/config.json) leggibile solo dal tuo account. Non viene mai scritta in un file di workflow né nei metadati di un’immagine salvata da ComfyUI, quindi condividere l’uno o l’altra non significa condividere la chiave. Dopo il salvataggio, il campo delle impostazioni mostra soltanto gli ultimi quattro caratteri. Per rimuovere la chiave, svuota il campo.

Su un server o in un container, imposta invece la variabile d’ambiente SPICY_API_KEY: ha la precedenza sul campo delle impostazioni.

Esegui il tuo primo nodo

Preferisci partire da un grafo già funzionante? Il browser dei template di ComfyUI elenca gli esempi del pacchetto sotto comfyui-spicyapi: da testo a immagine, da immagine a video, un modello di chat che scrive il prompt per un modello di immagini, sintesi vocale e LoRA.

Esempi pratici con risultati, prezzi e tempi di esecuzione reali, insieme all’elenco aggiornato dei nodi senza censura, sono nella pagina ComfyUI su spicyapi.ai.

Come funzionano i nodi

Ogni nodo viene generato dallo schema di input pubblicato del suo modello, lo stesso con cui l’API convalida le richieste, quindi un nodo non offre mai un’opzione che il modello rifiuterebbe.

Un menu a tendina impostato su model default, o un numero impostato su -1, viene lasciato fuori dalla richiesta, così il modello usa il proprio valore predefinito.

Le uscite sono normali valori di ComfyUI, quindi qualsiasi altro nodo può riceverle:

• I modelli di immagini restituiscono IMAGE. La rimozione dello sfondo restituisce anche una maschera alpha.
• I modelli video restituiscono VIDEO, più l’ultimo fotogramma della clip come IMAGE quando return_last_frame è attivo.
• I modelli audio restituiscono AUDIO. Un modello che restituisce più clip, come Suno, le restituisce come un unico batch e Save Audio scrive un file per ciascuna.
• La trascrizione restituisce STRING.
• Ogni nodo restituisce anche il proprio task_id, utile per i log della console o per una richiesta di assistenza.

Nodi Chat e LoRA

SpicyAPI Chat invia un prompt, istruzioni di sistema facoltative e immagini facoltative a qualsiasi modello di testo su SpicyAPI e restituisce la risposta come STRING. Collegalo al prompt di un nodo di immagini o video per far scrivere o rifinire i prompt a un modello linguistico all’interno del grafo. Un modello che non legge le immagini rifiuta l’input di immagini senza addebitare nulla.

SpicyAPI LoRA aggiunge un file di pesi LoRA, indicato con un link di download diretto a un file .safetensors, con un’intensità da 0 a 4. Concatenane più di uno per sovrapporli e collega l’ultimo all’ingresso loras di un nodo modello LoRA (i loro nomi finiscono con LoRA). Il link deve aprirsi senza effettuare l’accesso.

Quanto costa un’esecuzione

• Il badge su ogni nodo mostra la tariffa attuale del modello per le opzioni scelte, per esempio $0.0525/s per il video o $0.01/image, e cambia mentre modifichi le opzioni.
• Ogni esecuzione viene prima quotata. In Settings > SpicyAPI > Max cost per run imposta un tetto in dollari statunitensi. Un’esecuzione quotata sopra quel tetto si ferma prima che venga addebitato qualsiasi importo.
• L’addebito finale compare sul nodo al termine dell’esecuzione. Le esecuzioni non riuscite non vengono addebitate, tranne sui modelli la cui pagina indica che i rifiuti sono fatturati. Vedi Fatturazione.
• I seed partono su fixed. Mettere in coda due volte lo stesso grafo riutilizza il primo risultato invece di pagare di nuovo. Imposta control after generate su randomize per ottenere un nuovo risultato, e un nuovo addebito, a ogni esecuzione.
• Annullare ferma l’attesa, non il lavoro. Un’esecuzione annullata in ComfyUI continua su SpicyAPI, viene addebitata se riesce e il suo risultato si trova nei log della console.

I risultati restano nella tua console fino a 14 giorni, o meno se il tuo account li conserva per un periodo più breve. Usa i nodi Save di ComfyUI per tenere una tua copia. Vedi Conservazione e distruzione.

Risoluzione dei problemi

Gli errori di SpicyAPI terminano con un request_id o un ID attività. Citalo all’assistenza e la richiesta potrà essere ritrovata con precisione. I codici di errore sono spiegati in Errori.