PopNowDocs de la API
Integraciones
Contenido principal

Nodo de ComfyUI para generación en la nube

Ejecuta modelos de imagen, video y audio con IA en la nube dentro de ComfyUI con el paquete oficial de nodos de PopNow desde ComfyUI Manager, o con un solo archivo de nodo personalizado. Sin GPU ni descargas de modelos; pasos de instalación, entradas, precios y soluciones a errores.

El paquete oficial de nodos de PopNow pone todos los modelos de imagen, video y audio de PopNow en un grafo de ComfyUI. Cada nodo envía la tarea a la nube, espera y pasa el resultado al siguiente nodo. No se descarga nada a tu GPU, así que los modelos de video que necesitan mucha más memoria de la que tiene un portátil funcionan sin problemas desde un portátil.

El paquete es popnow-comfyui en el Comfy Registry, de código abierto en GitHub. Añade un nodo por modelo, un nodo PopNow Generate que acepta cualquier modelo por su nombre, y un nodo PopNow LoRA. Esta página coincide con la página de ComfyUI en popnow.ai.

Instalación en cuatro pasos

Instala el paquete de nodos

En ComfyUI, abre Manager > Custom Nodes Manager, busca PopNow, haz clic en Install y reinicia ComfyUI. Con Comfy CLI:

comfy node install popnow-comfyui

El paquete no necesita nada más que el propio ComfyUI (Python 3.10 o posterior). Para instalarlo desde el código fuente, clona popnow-comfyui en ComfyUI/custom_nodes.

Añade tu clave de API

Crea una clave en la consola de la API, abre Settings > PopNow en ComfyUI y pégala. Las ejecuciones gastan tu saldo independiente de la API en USD, que empieza en $0. Añade fondos en API billing; los créditos de la web no pueden pagar estas ejecuciones. También puedes definirla en el entorno desde el que inicias ComfyUI:

export POPNOW_API_KEY="sk-popnow-..."
python main.py

En las versiones portátiles de Windows, añade set POPNOW_API_KEY=sk-popnow-... al archivo .bat que inicia ComfyUI. Reinicia una vez más para que la lista de nodos se cargue desde tu cuenta.

Añade un nodo

Haz doble clic en el lienzo y escribe el nombre de un modelo (seedance, kling, wan, nano banana, suno …), o explora PopNow > Video / Image / Audio. PopNow Generate acepta cualquier ID de modelo de Modelos.

Encola

Conecta Load Image a la entrada de imagen si el modelo la necesita, conecta Save Image, Save Video o Save Audio, y encola el prompt. El explorador de plantillas de ComfyUI tiene grafos listos en popnow-comfyui.

El nodo de un solo archivo

Si prefieres un archivo que puedas leer en un minuto, el nodo PopNow Generate del paquete también existe como un único archivo de Python. Guárdalo como custom_nodes/popnow_api.py dentro de tu carpeta de ComfyUI, define POPNOW_API_KEY como arriba y reinicia ComfyUI. Solo usa requests, Pillow, NumPy y PyTorch, que ComfyUI ya incluye.

Instala el paquete o este archivo, no los dos: añaden el mismo nodo. Cuando pases al paquete, borra custom_nodes/popnow_api.py; los flujos guardados seguirán funcionando.

Entradas y salidas

Estas son las entradas y salidas de PopNow Generate, iguales en el paquete y en el archivo único. Los nodos por modelo del paquete muestran en su lugar los campos de cada modelo, como menús desplegables, deslizadores y conectores.

EntradaQué poner
modelUn ID de modelo de Modelos, por ejemplo google/nano-banana-2.1/text-to-image o minimax/h3/image-to-video
promptLo que quieres crear. Déjalo vacío para los modelos que no aceptan prompt
optionsLos demás campos del modelo en JSON, como {"resolution": "2k"} o {"duration_seconds": 5}. La página de cada modelo los enumera
image (opcional)Una IMAGE de otro nodo. Se sube por ti y se coloca en el campo indicado por image_field
image_fieldQué campo recibe la imagen: image_url para la mayoría de modelos de video, image_urls para la edición de imágenes
SalidaContiene
imageEl resultado como IMAGE para los modelos de imagen; un marcador en blanco para video y audio
urlLa URL firmada del archivo, válida durante unos 20 minutos
pathPara video y audio: dónde se guardó el archivo en la carpeta de salida de ComfyUI

Configuraciones habituales

Objetivomodeloptionsimage_field
Texto a imagengoogle/nano-banana-2.1/text-to-image{"aspect_ratio": "16:9", "resolution": "1k"}—
Editar un render localgoogle/nano-banana-2.1/edit{"resolution": "2k"}image_urls
Animar una imagen fijaminimax/h3/image-to-video{"duration_seconds": 5, "resolution": "768p"}image_url
Ampliar un fotogramapopnow/image-upscaler-v1/upscale{}image_url
Recortar el sujetopopnow/background-remover-v1/edit{}image_url

Un grafo híbrido típico: crea un fotograma inicial con un checkpoint local, anímalo en la nube con un modelo de imagen a video, y luego carga el MP4 guardado con un nodo de carga de video y amplíalo o interpólalo en local.

Qué hace el nodo por dentro

El nodo es una capa fina sobre tres llamadas REST; las mismas llamadas en otros lenguajes:

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "google/nano-banana-2.1/text-to-image", "input": {"prompt": "A lighthouse on a cliff at dusk, warm window light", "aspect_ratio": "16:9", "resolution": "1k"}}'

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=job_..." \
  -H "Authorization: Bearer $POPNOW_API_KEY"
JavaScript
const API = 'https://api.popnow.ai/api/v1';
const auth = { Authorization: `Bearer ${process.env.POPNOW_API_KEY}` };
const created = await fetch(`${API}/jobs/createTask`, {
  method: 'POST',
  headers: { ...auth, 'Content-Type': 'application/json', 'Idempotency-Key': crypto.randomUUID() },
  body: JSON.stringify({
    model: 'google/nano-banana-2.1/text-to-image',
    input: { prompt: 'A lighthouse on a cliff at dusk, warm window light', aspect_ratio: '16:9', resolution: '1k' },
  }),
}).then((r) => r.json());
console.log(created.data.taskId);

Subir la imagen de entrada es el flujo de tres pasos de Medios; el resultado es una referencia popnow://f/… que solo funciona con claves de tu propia cuenta.

Precios

Cada ejecución gasta USD de la API al precio normal del modelo; el nodo no añade nada. Nano Banana 2.1 en 1K cuesta $0.048 por imagen, y MiniMax H3 en 768p cuesta $0.185 por 5 segundos. Las ejecuciones fallidas no se cobran. Los precios de cada modelo están en su página y en Saldo de la API y reembolsos; usa jobs/quote para una cifra exacta.

Errores comunes

ComfyUI muestraPor quéSolución
No PopNow API key is set (paquete)No hay clave en Settings > PopNow ni en el entornoPega la clave en Settings > PopNow, o define POPNOW_API_KEY, y vuelve a ejecutar
Set POPNOW_API_KEY before starting ComfyUI (archivo único)La variable no está en el entorno de ComfyUIDefínela en la misma terminal o en el archivo .bat, y reinicia
PopNow 401: …Falta la clave, está mal escrita o fue revocadaCrea una clave nueva en la consola de la API
PopNow 400: … con el nombre de un campooptions tiene un campo que el modelo no acepta, o un valor fuera de rangoRevisa la página del modelo; los campos desconocidos se rechazan
PopNow 40201: …No hay USD suficientes en la APIAñade fondos en API billing, o baja la resolución o la duración
PopNow failed: …El modelo no pudo terminar o rechazó la solicitudNo se cobró nada; cambia el prompt o los ajustes
JSONDecodeErroroptions no es JSON válidoUsa comillas dobles: {"resolution": "2k"}
El nodo no aparece en la lista de búsquedaEl paquete o el archivo no está instalado, o no reiniciaste ComfyUIRevisa Custom Nodes Manager o la carpeta custom_nodes y reinicia; busca errores de importación en la consola
Un modelo de popnow.ai no tiene nodoEl paquete construye su lista de nodos con el catálogo de tu cuenta al iniciar ComfyUIReinicia ComfyUI, o usa PopNow Generate con el ID del modelo

¿Es un paquete oficial del registro de ComfyUI?

Sí. popnow-comfyui lo publica PopNow en el Comfy Registry, así que ComfyUI Manager y comfy node install popnow-comfyui lo encuentran. El código está en GitHub con licencia MIT. El nodo de un solo archivo de esta página es su nodo PopNow Generate en un solo archivo. Consulta SDK, CLI y herramientas de código abierto.

¿Funciona con ComfyUI Desktop y las versiones portátiles?

Sí. Funciona en cualquier lugar donde puedas instalar nodos personalizados: versión portátil, Desktop y servidores autoalojados.

¿Necesito una GPU?

No. La generación se ejecuta en PopNow; tu equipo solo envía la solicitud y recibe el archivo.

¿Cómo devuelvo los fotogramas de un video al grafo?

El nodo guarda el video en la carpeta de salida de ComfyUI y devuelve su ruta. Cárgalo con un nodo de carga de video para obtener los fotogramas.

En esta página