# ComfyUI BFL API Pro Nodes

Este nodo personalizado para ComfyUI proporciona integración completa con la API de BFL (Black Forest Labs) para mejorar y optimizar el procesamiento de imágenes. Permite utilizar todos los modelos de Flux Pro, Flux Kontext y Flux Ultra directamente dentro de ComfyUI, ofreciendo capacidades avanzadas de procesamiento de imágenes.

## Características

- ✅ **Integración completa con la API de BFL**
- ✅ **Múltiples modelos soportados**: Flux Pro, Flux Kontext, Flux Ultra, Flux 2 Pro, Flux 2 Flex
- ✅ **Inpainting y expansión de imágenes**
- ✅ **Sistema flexible de API keys** con prioridad automática
- ✅ **Procesamiento de imágenes optimizado**
- ✅ **Compatible con el flujo de trabajo de ComfyUI**
- ✅ **Manejo robusto de errores**
- ✅ **Salida de estado**: Todos los nodos incluyen salida de texto con mensajes de éxito o error
- ✅ **Descarga automática de imágenes** desde Azure Blob Storage

## Nodos Disponibles

### 🎨 Generación de Imágenes
- **BFL Image Generator (Pro 1.1)**: Generación básica de imágenes con Flux Pro 1.1
- **BFL Flux Ultra (Pro 1.1)**: Modelo Ultra para máxima calidad
- **BFL Flux 2 Pro**: Modelo Flux 2 Pro con soporte para hasta 8 imágenes de entrada
- **BFL Flux 2 Flex**: Modelo Flux 2 Flex con control avanzado (guidance, steps, prompt upsampling)

### 🔧 Edición y Manipulación
- **BFL Inpainting (Pro 1.0 Fill)**: Rellenado inteligente de áreas
- **BFL Image Expander (Pro 1.0)**: Expansión de imágenes con IA

### 🌟 Modelos Especializados
- **BFL Flux Kontext (Pro/Max)**: Modelos Kontext Pro y Max para casos especiales

### 📤 Salidas de los Nodos
Todos los nodos tienen **dos salidas**:
- **IMAGE**: La imagen generada o procesada (o imagen de error si falla)
- **STRING**: Mensaje de estado que indica éxito (✓) o error (✗) con detalles

## Instalación

1. Navega a la carpeta `custom_nodes` de tu instalación de ComfyUI
2. Clona este repositorio:
```bash
git clone https://github.com/charlyad142/ComfyUI_bfl_api_pro_nodes.git
```
3. Reinicia ComfyUI

## Configuración de API Key

### Opción 1: Archivo config.ini (Recomendado)
1. Crea un archivo `config.ini` en la raíz del nodo
2. Agrega la siguiente configuración:

```ini
[API]
X_KEY = tu_api_key_aquí
```

### Opción 2: Campo x_key en cada nodo
- Cada nodo tiene un campo `x_key` donde puedes ingresar tu API key directamente
- Útil para usar diferentes keys en diferentes nodos

### Sistema de Prioridad de API Keys
El sistema busca la API key en el siguiente orden:
1. **Archivo config.ini** (prioridad más alta)
2. **Campo x_key del nodo** (si config.ini no existe o no tiene key)
3. **Error** (si no hay key en ningún lado)

### Obtención de API Key

1. Regístrate en [BFL Platform](https://auth.bfl.ai/)
2. Ve a tu panel de control
3. En la sección de API Keys, genera una nueva key
4. Copia la key y pégala en tu archivo `config.ini` o en el campo `x_key` del nodo

## Uso

### Básico
1. En ComfyUI, busca los nodos "BFL" en el menú de nodos
2. Arrastra el nodo deseado a tu flujo de trabajo
3. Configura tu API key (en config.ini o en el campo x_key)
4. Conecta los nodos según tus necesidades

### Ejemplos de Uso

#### Generación de Imágenes
```
BFL Image Generator → Prompt → Output
```

#### Inpainting
```
Image + Mask → BFL Inpainting → Output
```

#### Expansión de Imágenes
```
Image → BFL Image Expander → Output
```

## Parámetros Comunes

### Campos Requeridos
- **prompt**: Descripción de la imagen a generar
- **x_key**: Tu API key de BFL
- **output_format**: Formato de salida (jpeg/png)
- **safety_tolerance**: Tolerancia de seguridad (varía según modelo: 0-5 o 0-6)

### Campos Opcionales
- **seed**: Semilla para reproducibilidad (-1 para aleatorio)
- **steps**: Número de pasos de generación (varía según modelo: 1-50 o 15-50)
- **guidance**: Guía de generación (varía según modelo: 1.5-10.0 o 1.0-100.0)
- **width/height**: Dimensiones de la imagen (mínimo 64px, solo se envía si > 0)

## Modelos Específicos

### Flux Pro 1.1
- **Versión 1.1**: Sin parámetros de steps/guidance
- **Image Prompt**: Soporte para imágenes de referencia opcionales

### Flux Ultra
- **Aspect Ratio**: Control de relación de aspecto
- **Raw Mode**: Modo raw para mayor control
- **Image Prompt**: Soporte para imágenes de referencia con control de fuerza

### Flux Kontext
- **Pro/Max**: Dos modelos especializados
- **Aspect Ratio**: Control de relación de aspecto
- **Hasta 4 imágenes de entrada**: Soporte para múltiples imágenes de contexto

### Flux 2 Pro
- **Hasta 8 imágenes de entrada**: Soporte para múltiples imágenes de contexto
- **Width/Height**: Control de dimensiones (mínimo 64px)
- **Sin parámetros de guidance/steps**: Modelo simplificado

### Flux 2 Flex
- **Hasta 8 imágenes de entrada**: Soporte para múltiples imágenes de contexto
- **Input Image Blob Path**: Soporte para rutas de blob como alternativa
- **Guidance**: Control de guía (1.5-10.0, default: 5.0)
- **Steps**: Control de pasos (1-50, default: 50)
- **Prompt Upsampling**: Activación de upsampling del prompt (default: true)
- **Width/Height**: Control de dimensiones (mínimo 64px)

## Solución de Problemas

### Error de API Key
```
"No se encontró una API key válida. Por favor, configure una API key en el nodo o en el archivo config.ini"
```
**Solución**: Verifica que tu API key esté configurada correctamente en config.ini o en el campo x_key del nodo.

### Error de Conexión
```
"API Error 401: Unauthorized"
```
**Solución**: Verifica que tu API key sea válida y tenga créditos disponibles.

### Error de Formato
```
"Invalid API response format"
```
**Solución**: Verifica que todos los parámetros requeridos estén configurados correctamente.

## Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Fork el repositorio
2. Crea una rama para tu feature
3. Commit tus cambios
4. Push a la rama
5. Abre un Pull Request

## Licencia

Este proyecto está bajo la Licencia MIT. Ver el archivo `LICENSE` para más detalles.

## Soporte

Para soporte técnico o preguntas:
- Abre un issue en GitHub
- Consulta la documentación de BFL: [BFL Platform](https://auth.bfl.ai/)

## Changelog

### v3.0.0
- ✅ Agregado soporte para Flux 2 Pro y Flux 2 Flex
- ✅ Agregada salida de texto (STRING) a todos los nodos con mensajes de estado
- ✅ Mejorado el manejo de descarga de imágenes desde Azure Blob Storage
- ✅ Eliminados nodos Canny y Depth Control (ya no disponibles en la API)
- ✅ Actualizado Image Generator para usar solo versión 1.1
- ✅ Mejorado el manejo de errores con mensajes más descriptivos
- ✅ Timeout aumentado para descargas de imágenes (60 segundos)

### v2.0.0
- ✅ Agregado soporte para Flux Ultra
- ✅ Agregado nodo de Depth Control
- ✅ Agregado nodo de Flux Kontext
- ✅ Sistema flexible de API keys con prioridad automática
- ✅ Mejorado el manejo de errores
- ✅ Eliminados campos de webhook innecesarios

### v1.0.0
- ✅ Nodos básicos de generación, inpainting y control
- ✅ Soporte para config.ini
- ✅ Integración con ComfyUI