Nodes do ComfyUI

O pacote de nodes da SpicyAPI para o ComfyUI transforma cada modelo de imagem, vídeo e áudio da SpicyAPI em um node do ComfyUI: são mais de 180, além de um node SpicyAPI Chat para modelos de texto e um node SpicyAPI LoRA. Os modelos rodam nos servidores da SpicyAPI, então você precisa de conexão com a internet e de uma chave de API, não de uma placa de vídeo nem de pesos baixados. Cada node mostra o preço antes de rodar e imprime o custo da execução quando termina.

O pacote é gratuito e de código aberto (MIT) em github.com/spicyapi-ai/comfyui-spicyapi. Ele não instala nada além do próprio ComfyUI.

Esta é a ferramenta certa?

Todos usam a mesma conta, o mesmo saldo, os mesmos modelos e os mesmos preços.

Antes de começar

• Um ComfyUI recente. Os nodes usam a API de nodes V3 do ComfyUI e foram testados com o ComfyUI 0.39. Qualquer instalação que carregue pastas de custom_nodes serve: o app para desktop, a versão portátil ou uma instalação manual.
• Uma chave de API. Crie uma no console; ela começa com sk-spicy-. Se ainda não tem conta, veja Prepare sua conta.
• Saldo. Cada execução é paga com o seu saldo pré-pago em dólares americanos. Veja Cobrança.
• Acesso a api.spicyapi.ai a partir da máquina que roda o ComfyUI. Um proxy definido em HTTPS_PROXY é respeitado.

Instalação

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

Adicione a sua chave de API

Abra Settings > SpicyAPI > API key e cole a sua chave. Um aviso confirma que a chave funciona e mostra o seu saldo disponível. Depois reinicie o ComfyUI uma vez: a lista de nodes é montada a partir do catálogo ativo da sua conta quando o ComfyUI inicia e, enquanto não há chave, vale a lista que acompanha a versão instalada.

A chave fica guardada num arquivo na pasta de usuário do ComfyUI (user/spicyapi/config.json) que só a sua conta consegue ler. Ela nunca é gravada num arquivo de workflow nem nos metadados de uma imagem que o ComfyUI salva, então compartilhar um dos dois não compartilha a sua chave. Depois disso, o campo nas configurações mostra só os quatro últimos caracteres. Para remover a chave, apague o campo.

Num servidor ou num contêiner, defina a variável de ambiente SPICY_API_KEY. Ela tem prioridade sobre o campo das configurações.

Rode o seu primeiro node

Prefere começar de um grafo pronto? O navegador de templates do ComfyUI lista os exemplos do pacote em comfyui-spicyapi: texto para imagem, imagem para vídeo, um modelo de conversa escrevendo o prompt de um modelo de imagem, texto para fala e LoRA.

Exemplos prontos com resultados, preços e tempos de execução reais, além da lista atualizada de nodes sem censura, estão na página do ComfyUI em spicyapi.ai.

Como os nodes funcionam

Cada node é gerado a partir do schema de entrada publicado do modelo, o mesmo contra o qual a API valida as requisições, então um node nunca oferece uma opção que o modelo recusaria.

Uma lista suspensa em model default, ou um número em -1, fica fora da requisição, e o modelo usa o próprio valor padrão.

As saídas são valores comuns do ComfyUI, então qualquer outro node pode recebê-las:

• Modelos de imagem devolvem IMAGE. A remoção de fundo devolve também uma máscara alpha.
• Modelos de vídeo devolvem VIDEO e, com return_last_frame ligado, o último quadro do clipe como IMAGE.
• Modelos de áudio devolvem AUDIO. Um modelo que devolve vários clipes, como o Suno, entrega todos num único lote, e Save Audio grava um arquivo para cada um.
• A transcrição devolve STRING.
• Todo node também devolve o seu task_id, para os registros do console ou para um pedido ao suporte.

Nodes de Chat e de LoRA

O SpicyAPI Chat envia um prompt, instruções de sistema opcionais e imagens opcionais a qualquer modelo de texto da SpicyAPI e devolve a resposta como STRING. Ligue-o ao prompt de um node de imagem ou vídeo para que um modelo de linguagem escreva ou refine prompts dentro do grafo. Um modelo que não lê imagens recusa a entrada de imagem sem cobrar nada.

O SpicyAPI LoRA adiciona um arquivo de pesos LoRA, informado como link de download direto para um arquivo .safetensors, com intensidade de 0 a 4. Encadeie vários para combiná-los e conecte o último à entrada loras de um node de modelo LoRA (os nomes deles terminam em LoRA). O link precisa abrir sem login.

Quanto custa uma execução

• O selo em cada node mostra a tarifa atual do modelo para as opções escolhidas, por exemplo $0.0525/s para vídeo ou $0.01/image, e muda conforme você muda as opções.
• Toda execução é cotada antes. Em Settings > SpicyAPI > Max cost per run, defina um teto em dólares americanos. Uma execução cotada acima dele para antes de qualquer cobrança.
• A cobrança final aparece no node quando a execução termina. Execuções que falham não são cobradas, exceto em modelos cuja página informa que recusas são cobradas. Veja Cobrança.
• As seeds começam em fixed. Enfileirar o mesmo grafo duas vezes reaproveita o primeiro resultado em vez de pagar de novo. Mude control after generate para randomize para obter um resultado novo, e uma cobrança nova, a cada execução.
• Cancelar interrompe a espera, não o trabalho. Uma execução que você cancela no ComfyUI continua na SpicyAPI, é cobrada se der certo, e o resultado fica nos registros do console.

Os resultados ficam no seu console por até 14 dias, ou menos se a sua conta os guarda por menos tempo. Use os nodes Save do ComfyUI para ficar com a sua própria cópia. Veja Retenção e destruição.

Solução de problemas

Os erros da SpicyAPI terminam com um request_id ou um ID de tarefa. Informe-o ao suporte e a requisição pode ser encontrada com exatidão. Os códigos de erro estão explicados em Erros.