205 lines
7.0 KiB
Markdown
205 lines
7.0 KiB
Markdown
# 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
|