ComfyUI Extension: ComfyUI Replicate Image Generation & Edit

Authored by charlyad142

Created

Updated

0 stars

This nodepack lets you use several Replicate models for image generation and editing: Qwen Image Edit Plus (Multi-Image) for editing multiple images using reference poses, Qwen Image Edit (Single Image) for single-image edits with text instructions, SeedEdit 3.0 (ByteDance) for advanced prompt-controlled editing, and Seedream 4.0 (ByteDance) for high-quality multi-resolution image generation.

Custom Nodes (0)

    README

    ComfyUI Replicate Image Generation & Edit

    Este nodo de ComfyUI permite usar varios modelos de Replicate para generar y editar imágenes:

    • Qwen Image Edit Plus (Multi-Image): Usa qwen/qwen-image-edit-plus para editar múltiples imágenes basándose en poses de referencia
    • Qwen Image Edit (Single Image): Usa qwen/qwen-image-edit para editar una sola imagen con instrucciones de texto
    • SeedEdit 3.0 (ByteDance): Usa bytedance/seededit-3.0 para edición avanzada de imágenes con control de adherencia al prompt
    • Seedream 4.0 (ByteDance): Usa bytedance/seedream-4 para generación de imágenes de alta calidad con múltiples resoluciones

    Características

    Qwen Image Edit Plus (Multi-Image)

    • Edición de múltiples imágenes: Acepta 1-5 imágenes, la primera como referencia de pose
    • Edición basada en poses: Las demás imágenes adoptan la pose de la primera imagen
    • Flexibilidad: Puedes usar entre 1 y 5 imágenes según tus necesidades

    Qwen Image Edit (Single Image)

    • Edición de imagen única: Acepta una sola imagen para editar
    • Instrucciones de texto: Usa prompts de texto para describir cómo editar la imagen
    • Simplicidad: Ideal para ediciones directas con instrucciones claras

    SeedEdit 3.0 (ByteDance)

    • Edición avanzada: Modelo especializado de ByteDance para edición de imágenes
    • Control de adherencia: Parámetro guidance_scale para controlar qué tan literal es el resultado
    • Alta calidad: Optimizado para ediciones precisas y detalladas

    Seedream 4.0 (ByteDance)

    • Generación de imágenes: Modelo de ByteDance para generar imágenes desde texto
    • Múltiples resoluciones: Soporte para 1K, 2K, 4K y dimensiones personalizadas
    • Generación secuencial: Opción para generar múltiples imágenes relacionadas
    • Image-to-image: Soporte para generación basada en imágenes de entrada

    Características generales

    • Integración con Replicate API: Utiliza la API oficial de Replicate
    • Configuración flexible: Soporte para múltiples parámetros de configuración
    • Manejo de errores robusto: Gestión completa de errores y timeouts

    Instalación

    1. Coloca este nodo en la carpeta custom_nodes de ComfyUI
    2. Instala las dependencias necesarias:
      pip install replicate requests pillow
      

    Configuración

    Opción 1: Variable de entorno (Recomendado)

    export REPLICATE_API_TOKEN="tu_token_aqui"
    

    Opción 2: Archivo de configuración

    Edita el archivo config.ini y reemplaza tu_token_aqui con tu token de API de Replicate.

    Opción 3: Token en el nodo

    Puedes ingresar el token directamente en el campo api_token del nodo.

    Uso

    Qwen Image Edit Plus (Multi-Image)

    1. images: Una o más imágenes (mínimo 1, máximo 5). La primera imagen se usa como referencia de pose, las demás se editan.
    2. prompt: Descripción de cómo quieres que se edite la imagen (ej: "The person in the second image adopts the pose from the first image")
    3. api_token: Token de API de Replicate (opcional si está configurado en variables de entorno)

    Qwen Image Edit (Single Image)

    1. image: Una sola imagen para editar
    2. prompt: Instrucciones de texto sobre cómo editar la imagen (ej: "Make the person wear a red shirt", "Change the background to a beach")
    3. api_token: Token de API de Replicate (opcional si está configurado en variables de entorno)

    SeedEdit 3.0 (ByteDance)

    1. image: Una sola imagen para editar
    2. prompt: Instrucciones de texto sobre cómo editar la imagen
    3. api_token: Token de API de Replicate (opcional si está configurado en variables de entorno)

    Seedream 4.0 (ByteDance)

    1. prompt: Descripción de la imagen que quieres generar
    2. api_token: Token de API de Replicate (opcional si está configurado en variables de entorno)
    3. image_input (opcional): Imagen de referencia para generación image-to-image

    Parámetros opcionales

    Para Qwen Image Edit Plus y Qwen Image Edit:

    • seed: Semilla aleatoria para generación reproducible (-1 para aleatorio)
    • go_fast: Ejecutar predicciones más rápidas con optimizaciones adicionales (por defecto: True)
    • aspect_ratio: Proporción de aspecto para la imagen generada (por defecto: "match_input_image")
    • output_format: Formato de salida (por defecto: "webp")
    • output_quality: Calidad de salida de 0 a 100 (por defecto: 95)
    • disable_safety_checker: Deshabilitar el verificador de seguridad (por defecto: False)

    Para SeedEdit 3.0:

    • seed: Semilla aleatoria para generación reproducible (-1 para aleatorio)
    • guidance_scale: Control de adherencia al prompt (1.0-10.0, por defecto: 5.5)
      • Valores más altos = más literal al prompt
      • Valores más bajos = más creativo/artístico

    Para Seedream 4.0:

    • size: Resolución de la imagen (1K, 2K, 4K, custom)
    • width: Ancho personalizado (1024-4096, solo cuando size='custom')
    • height: Alto personalizado (1024-4096, solo cuando size='custom')
    • max_images: Número máximo de imágenes a generar (1-15)
    • aspect_ratio: Proporción de aspecto de la imagen
    • sequential_image_generation: Modo de generación (disabled, auto)

    Salidas

    • image: Imagen editada como tensor de ComfyUI
    • output_url: URL de la imagen generada en Replicate

    Ejemplos de uso

    Qwen Image Edit Plus (Multi-Image)

    1. Carga una o más imágenes en el campo images (mínimo 1, máximo 5)
    2. La primera imagen se usa como referencia de pose
    3. Las demás imágenes se editarán para adoptar la pose de la primera
    4. Escribe un prompt descriptivo como "The person in the second image adopts the pose from the first image"
    5. Configura tu token de API
    6. Ejecuta el nodo

    Qwen Image Edit (Single Image)

    1. Carga una imagen en el campo image
    2. Escribe instrucciones claras como "Make the person wear a red shirt" o "Change the background to a beach"
    3. Configura tu token de API
    4. Ejecuta el nodo

    SeedEdit 3.0 (ByteDance)

    1. Carga una imagen en el campo image
    2. Escribe instrucciones detalladas sobre cómo editar la imagen
    3. Ajusta el guidance_scale según necesites más o menos adherencia al prompt
    4. Configura tu token de API
    5. Ejecuta el nodo

    Seedream 4.0 (ByteDance)

    1. Escribe un prompt descriptivo de la imagen que quieres generar
    2. Selecciona la resolución (1K, 2K, 4K o custom)
    3. Si usas 'custom', configura width y height
    4. Opcionalmente conecta una imagen de referencia en image_input
    5. Configura tu token de API
    6. Ejecuta el nodo

    Obtener token de API

    1. Ve a https://replicate.com/account/api-tokens
    2. Crea una cuenta o inicia sesión
    3. Genera un nuevo token de API
    4. Copia el token y configúralo según una de las opciones anteriores

    Notas

    • El nodo convierte las imágenes de entrada a formato base64 para enviarlas a la API
    • La imagen de salida se descarga automáticamente y se convierte al formato de tensor de ComfyUI
    • El nodo incluye manejo de errores completo y mensajes informativos