ComfyUI Gateway

Visão Geral

Gateway de API REST para servidores ComfyUI. Gerenciamento de fluxo de trabalho, fila de trabalhos, webhooks, cache, autenticação, limitação de taxa e entrega de imagens (URL + base64).

Quando Usar Esta Ferramenta

• Quando o usuário mencionar "comfyui" ou tópicos relacionados
• Quando o usuário mencionar "comfy ui" ou tópicos relacionados
• Quando o usuário mencionar "stable diffusion api gateway" ou tópicos relacionados
• Quando o usuário mencionar "gateway comfyui" ou tópicos relacionados
• Quando o usuário mencionar "api gateway imagens" ou tópicos relacionados
• Quando o usuário mencionar "queue imagens" ou tópicos relacionados

Não Use Esta Ferramenta Quando

• A tarefa não estiver relacionada ao gateway comfyui
• Uma ferramenta mais simples e específica puder lidar com a solicitação
• O usuário precisar de assistência de propósito geral sem conhecimento de domínio

Como Funciona

Um gateway de API REST de nível de produção que transforma qualquer servidor ComfyUI em um serviço universal, seguro e escalável. Suporta modelos de fluxo de trabalho com placeholders, fila de trabalhos com prioridades, callbacks de webhook, cache de resultados e múltiplos backends de armazenamento.

Visão Geral da Arquitetura

┌─────────────┐     ┌──────────────────────────────────┐     ┌──────────┐
│   Clients    │────▶│        ComfyUI Gateway           │────▶│ ComfyUI  │
│ (curl, n8n,  │     │                                  │     │ Server   │
│  Claude,     │     │  ┌─────────┐  ┌──────────────┐  │     │ (local/  │
│  Lovable,    │     │  │ Fastify │  │ BullMQ Queue │  │     │  remote) │
│  Supabase)   │     │  │ API     │──│ (or in-mem)  │  │     └──────────┘
│              │◀────│  └─────────┘  └──────────────┘  │
│              │     │  ┌─────────┐  ┌──────────────┐  │     ┌──────────┐
│              │     │  │ Auth +  │  │ Storage      │  │────▶│ S3/MinIO │
│              │     │  │ RateL.  │  │ (local/S3)   │  │     │(optional)│
│              │     │  └─────────┘  └──────────────┘  │     └──────────┘
└─────────────┘     └──────────────────────────────────┘

Componentes

Início Rápido

## 1. Install

cd comfyui-gateway
npm install

## 2. Configure

cp .env.example .env

## 3. Initialize

npx tsx src/cli/index.ts init

## 4. Add A Workflow

npx tsx src/cli/index.ts add-workflow ./workflows/sdxl_realism_v1.json \
  --id sdxl_realism_v1 --schema ./workflows/sdxl_realism_v1.schema.json

## 5. Start (Api + Worker In One Process)

npm run dev

## Or Separately:

npm run start:api   # API only
npm run start:worker # Worker only

Variáveis de Ambiente

Toda a configuração é feita via .env — nada é codificado:

…