Diffusers documentation
Lumina-T2X
Lumina-T2X
Lumina-Next: Making Lumina-T2X Stronger and Faster with Next-DiT de Alpha-VLLM, OpenGVLab, Shanghai AI Laboratory.
El resumen del artículo es:
Lumina-T2X es una familia incipiente de Flow-based Large Diffusion Transformers (Flag-DiT) que establece un marco unificado para transformar ruido en diversas modalidades, como imágenes y videos, condicionado por instrucciones de texto. A pesar de sus capacidades prometedoras, Lumina-T2X aún enfrenta desafíos como la inestabilidad del entrenamiento, la inferencia lenta y los artefactos de extrapolación. En este artículo, presentamos Lumina-Next, una versión mejorada de Lumina-T2X, que muestra un rendimiento de generación más fuerte con una mayor eficiencia en el entrenamiento y la inferencia. Comenzamos con un análisis exhaustivo de la arquitectura Flag-DiT e identificamos varios componentes subóptimos, a los que abordamos introduciendo la arquitectura Next-DiT con 3D RoPE y normalizaciones de sándwich. Para habilitar una mejor extrapolación de resolución, comparamos a fondo diferentes métodos de extrapolación de contexto aplicados a la generación de texto a imagen con 3D RoPE, y proponemos Frequency- and Time-Aware Scaled RoPE adaptado para diffusion transformers. Además, introducimos un programa de discretización de tiempo sigmoide para reducir los pasos de muestreo en la resolución del Flow ODE y el método Context Drop para fusionar tokens visuales redundantes para una evaluación de red más rápida, mejorando efectivamente la velocidad general de muestreo. Gracias a estas mejoras, Lumina-Next no solo mejora la calidad y la eficiencia de la generación básica de texto a imagen, sino que también demuestra capacidades superiores de extrapolación de resolución y generación multilingüe utilizando LLMs basados en decodificadores como codificador de texto, todo de manera zero-shot. Para validar aún más Lumina-Next como un marco generativo versátil, lo instanciamos en diversas tareas, incluida la reconocimiento visual, multi-vista, audio, música y generación de nubes de puntos, mostrando un rendimiento sólido en estos dominios. Al liberar todos los códigos y pesos del modelo en https://github.com/Alpha-VLLM/Lumina-T2X, buscamos avanzar en el desarrollo de la IA generativa de próxima generación capaz de modelado universal.
Aspectos destacados: Lumina-Next es un Diffusion Transformer de próxima generación que mejora significativamente la generación de texto a imagen, la generación multilingüe y el rendimiento multitarea mediante la introducción de la arquitectura Next-DiT, 3D RoPE y RoPE consciente de la frecuencia y el tiempo, entre otras mejoras.
Lumina-Next tiene los siguientes componentes:
- Mejora la eficiencia de muestreo con menos y más rápidos pasos.
- Utiliza un Next-DiT como columna vertebral de transformador con Sandwichnorm 3D RoPE y Grouped-Query Attention.
- Utiliza un RoPE escalado consciente de la frecuencia y el tiempo.
Lumina-T2X: Transformando texto en cualquier modalidad, resolución y duración mediante grandes transformadores de difusión basados en flujo de Alpha-VLLM, OpenGVLab, Shanghai AI Laboratory.
El resumen del artículo es:
Sora revela el potencial de escalar Diffusion Transformer para generar imágenes y videos fotorrealistas en resoluciones, relaciones de aspecto y duraciones arbitrarias, aunque aún carece de detalles de implementación suficientes. En este informe técnico, presentamos la familia Lumina-T2X, una serie de grandes Diffusion Transformers basados en flujo (Flag-DiT) equipados con atención inicializada en cero, como un marco unificado diseñado para transformar ruido en imágenes, videos, objetos 3D multivista y clips de audio condicionados por instrucciones de texto. Al tokenizar el espacio espacial-temporal latente e incorporar marcadores de posición aprendibles como los tokens [nextline] y [nextframe], Lumina-T2X unifica sin fisuras las representaciones de diferentes modalidades a través de diversas resoluciones espaciales-temporales. Este enfoque unificado permite el entrenamiento dentro de un único marco para diferentes modalidades y posibilita la generación flexible de datos multimodales en cualquier resolución, relación de aspecto y longitud durante la inferencia. Técnicas avanzadas como RoPE, RMSNorm y flow matching mejoran la estabilidad, flexibilidad y escalabilidad de Flag-DiT, lo que permite que los modelos de Lumina-T2X escalen hasta 7 mil millones de parámetros y extiendan la ventana de contexto a 128K tokens. Esto es particularmente beneficioso para crear imágenes de ultra alta definición con nuestro modelo Lumina-T2I y videos largos en 720p con nuestro modelo Lumina-T2V. Notablemente, Lumina-T2I, impulsado por un Flag-DiT de 5 mil millones de parámetros, requiere solo el 35% de los costos computacionales de entrenamiento de un DiT ingenuo de 600 millones de parámetros. Nuestro análisis exhaustivo posterior subraya la capacidad preliminar de Lumina-T2X en la extrapolación de resolución, la edición de alta resolución, la generación de vistas 3D consistentes y la síntesis de videos con transiciones fluidas. Esperamos que la publicación abierta de Lumina-T2X fomente aún más la creatividad, la transparencia y la diversidad en la comunidad de IA generativa.
Puedes encontrar el código original en Alpha-VLLM y todos los checkpoints disponibles en Alpha-VLLM Lumina Family.
Aspectos destacados: Lumina-T2X admite cualquier modalidad, resolución y duración.
Lumina-T2X tiene los siguientes componentes:
- Utiliza un Large Diffusion Transformer basado en Flow como columna vertebral
- Admite diferentes modalidades con un único backbone y el codificador y decodificador correspondientes.
Este pipeline fue aportado por PommesPeter. La base de código original se puede encontrar aquí. Los pesos originales se pueden encontrar en hf.co/Alpha-VLLM.
Asegúrate de consultar la guía de Schedulers para aprender a explorar el equilibrio entre la velocidad y la calidad del scheduler, y consulta la sección reutilizar componentes entre pipelines para aprender a cargar eficientemente los mismos componentes en múltiples pipelines.
Inferencia (Texto a imagen)
Use torch.compile para reducir la latencia de inferencia.
Primero, carga el pipeline:
from diffusers import LuminaPipeline
import torch
pipeline = LuminaPipeline.from_pretrained(
"Alpha-VLLM/Lumina-Next-SFT-diffusers", dtype=torch.bfloat16
).to("cuda") # or "mps", "xpu", "cpu"Luego, cambia el diseño de memoria de los componentes transformer y vae de los pipelines a torch.channels-last:
pipeline.transformer.to(memory_format=torch.channels_last) pipeline.vae.to(memory_format=torch.channels_last)
Por último, compile los componentes y ejecute la inferencia:
pipeline.transformer = torch.compile(pipeline.transformer, mode="max-autotune", fullgraph=True)
pipeline.vae.decode = torch.compile(pipeline.vae.decode, mode="max-autotune", fullgraph=True)
image = pipeline(prompt="Upper body of a young woman in a Victorian-era outfit with brass goggles and leather straps. Background shows an industrial revolution cityscape with smoky skies and tall, metal structures").images[0]Cuantización
La cuantización ayuda a reducir los requisitos de memoria de los modelos muy grandes almacenando los pesos del modelo en un tipo de datos de menor precisión. Sin embargo, la cuantización puede tener un impacto variable en la calidad del vídeo dependiendo del modelo de vídeo.
Consulte el resumen de Quantization para obtener más información sobre los backends de cuantización admitidos y la selección de un backend de cuantización que admita su caso de uso. El siguiente ejemplo demuestra cómo cargar un LuminaPipeline cuantizado para inferencia con bitsandbytes.
import torch
from diffusers import BitsAndBytesConfig as DiffusersBitsAndBytesConfig, Transformer2DModel, LuminaPipeline
from transformers import BitsAndBytesConfig as BitsAndBytesConfig, T5EncoderModel
quant_config = BitsAndBytesConfig(load_in_8bit=True)
text_encoder_8bit = T5EncoderModel.from_pretrained(
"Alpha-VLLM/Lumina-Next-SFT-diffusers",
subfolder="text_encoder",
quantization_config=quant_config,
dtype=torch.float16,
)
quant_config = DiffusersBitsAndBytesConfig(load_in_8bit=True)
transformer_8bit = Transformer2DModel.from_pretrained(
"Alpha-VLLM/Lumina-Next-SFT-diffusers",
subfolder="transformer",
quantization_config=quant_config,
dtype=torch.float16,
)
pipeline = LuminaPipeline.from_pretrained(
"Alpha-VLLM/Lumina-Next-SFT-diffusers",
text_encoder=text_encoder_8bit,
transformer=transformer_8bit,
dtype=torch.float16,
device_map="balanced",
)
prompt = "a tiny astronaut hatching from an egg on the moon"
image = pipeline(prompt).images[0]
image.save("lumina.png")LuminaPipeline
clase diffusers.LuminaPipeline
< source >( transformer: LuminaNextDiT2DModelscheduler: FlowMatchEulerDiscreteSchedulervae: AutoencoderKLtext_encoder: GemmaPreTrainedModeltokenizer: GemmaTokenizer )
Parámetros
- vae (AutoencoderKL) — Modelo de Variational Auto-Encoder (VAE) para codificar y decodificar imágenes a partir de y hacia representaciones latentes.
- text_encoder (
GemmaPreTrainedModel) — Codificador de texto Gemma congelado. - tokenizer (
GemmaTokenizeroGemmaTokenizerFast) — Tokenizador de Gemma. - transformer (Transformer2DModel) —
Un
Transformer2DModelcondicionado por texto para desruidar los latentes de imagen codificados. - scheduler (SchedulerMixin) —
Un scheduler para usar en combinación con
transformerpara desruidar los latentes de la imagen codificada.
Pipeline para la generación de imágenes a partir de texto usando Lumina-T2I.
Este modelo hereda de DiffusionPipeline. Consulta la documentación de la clase superior para los métodos genéricos que la biblioteca implementa para todos los pipelines (como la descarga o el guardado, la ejecución en un dispositivo específico, etc.)
__call__
< source >( prompt: str | list[str] = Nonewidth: int | None = Noneheight: int | None = Nonenum_inference_steps: int = 30guidance_scale: float = 4.0negative_prompt: str | list[str] = Nonesigmas: list = Nonenum_images_per_prompt: int | None = 1generator: typing.Union[torch.Generator, list[torch.Generator], NoneType] = Nonelatents: typing.Optional[torch.Tensor] = Noneprompt_embeds: typing.Optional[torch.Tensor] = Nonenegative_prompt_embeds: typing.Optional[torch.Tensor] = Noneprompt_attention_mask: typing.Optional[torch.Tensor] = Nonenegative_prompt_attention_mask: typing.Optional[torch.Tensor] = Noneoutput_type: str | None = 'pil'return_dict: bool = Trueclean_caption: bool = Truemax_sequence_length: int = 256scaling_watershed: float | None = 1.0proportional_attn: bool | None = Truecallback_on_step_end: typing.Union[typing.Callable[[int, int], NoneType], diffusers.callbacks.PipelineCallback, diffusers.callbacks.MultiPipelineCallbacks, NoneType] = Nonecallback_on_step_end_tensor_inputs: list = ['latents'] ) → ImagePipelineOutput or tuple
Parámetros
- prompt (
strolist[str], opcional) — El prompt o los prompts para guiar la generación de la imagen. Si no se define, hay que pasarprompt_embedsen su lugar. - negative_prompt (
strolist[str], opcional) — El prompt o prompts que no deben guiar la generación de la imagen. Si no se define, se debe pasarnegative_prompt_embedsen su lugar. Se ignora cuando no se usa guía (es decir, se ignora siguidance_scalees menor que1). - num_inference_steps (
int, opcional, valor predeterminado 30) — El número de pasos de desruido. Más pasos de desruido suelen conducir a una imagen de mayor calidad a costa de una inferencia más lenta. - sigmas (
list[float], opcional) — Sigmas personalizados para usar en el proceso de desruido con programadores que admiten un argumentosigmasen su métodoset_timesteps. Si no se define, se usará el comportamiento predeterminado cuando se pasenum_inference_steps. - guidance_scale (
float, opcional, valor predeterminado 4.0) — Escala de guía definida en Classifier-Free Diffusion Guidance.guidance_scalese define comowde la ecuación 2 del Imagen Paper. La escala de guía se habilita estableciendoguidance_scale > 1. Una escala de guía más alta fomenta la generación de imágenes estrechamente vinculadas alpromptde texto, generalmente a costa de una menor calidad de imagen. - num_images_per_prompt (
int, opcional, valor predeterminado 1) — El número de imágenes que se generarán por indicación. - height (
int, opcional, valor predeterminado: self.unet.config.sample_size) — La altura en píxeles de la imagen generada. - width (
int, opcional, predeterminado: self.unet.config.sample_size) — El ancho en píxeles de la imagen generada. - generator (
torch.Generatorolist[torch.Generator], opcional) — Un generador o una lista de generadores de torch para hacer la generación determinista. - latents (
torch.Tensor, opcional) — Latentes ruidosos pregenerados, muestreados de una distribución gaussiana, que se usarán como entradas para la generación de imágenes. Se pueden utilizar para ajustar la misma generación con diferentes prompts. Si no se proporcionan, se generará un tensor de latentes mediante muestreo usando elgeneratoraleatorio suministrado. - prompt_embeds (
torch.Tensor, opcional) — Incrustaciones de texto pregeneradas. Se pueden usar para ajustar fácilmente las entradas de texto, p. ej. ponderación de prompts. Si no se proporcionan, las incrustaciones de texto se generarán a partir del argumento de entradaprompt. - prompt_attention_mask (
torch.Tensor, opcional) — Máscara de atención pregenerada para las incrustaciones de texto. - negative_prompt_embeds (
torch.Tensor, opcional) — Incrustaciones de texto negativo pregeneradas. Para Lumina-T2I, este prompt negativo debe ser "". Si no se proporciona, negative_prompt_embeds se generará a partir del argumento de entradanegative_prompt. - negative_prompt_attention_mask (
torch.Tensor, opcional) — Máscara de atención pregenerada para los embeddings de texto negativos. - output_type (
str, opcional, valor predeterminado"pil") — El formato de salida de la imagen generada. Elija entre PIL:PIL.Image.Imageonp.array. - return_dict (
bool, opcional, valor predeterminadoTrue) — Indica si se debe devolver un~pipelines.stable_diffusion.IFPipelineOutputen lugar de una tupla simple. - clean_caption (
bool, opcional, valor predeterminadoTrue) — Indica si se debe limpiar la descripción antes de crear los embeddings. Requiere quebeautifulsoup4yftfyestén instalados. Si las dependencias no están instaladas, los embeddings se crearán a partir del prompt sin procesar. - max_sequence_length (
intpor defecto 120) — Longitud máxima de la secuencia a utilizar con elprompt. - scaling_watershed (
float, opcional, valor predeterminado 1.0) — Umbral de escalado de resolución utilizado por Lumina para cambiar entre la atención de contexto estándar y la de contexto extendido. - proportional_attn (
bool, opcional, valor predeterminado True) — Si se debe escalar la atención de forma proporcional para la generación de alta resolución. - callback_on_step_end (
Callable, opcional) — Una función que se llama al final de cada paso de desruido durante la inferencia. La función se llama con los siguientes argumentos:callback_on_step_end(self: DiffusionPipeline, step: int, timestep: int, callback_kwargs: Dict).callback_kwargsincluirá una lista de todos los tensores especificados porcallback_on_step_end_tensor_inputs. - callback_on_step_end_tensor_inputs (
list, opcional) — La lista de entradas de tensor para la funcióncallback_on_step_end. Los tensores especificados en la lista se pasarán como argumentocallback_kwargs. Solo podrás incluir variables listadas en el atributo._callback_tensor_inputsde tu clase de pipeline.
Devuelve
ImagePipelineOutput o tuple
Si return_dict es True, se devuelve ImagePipelineOutput; en caso contrario, se devuelve una tuple cuyo primer elemento es una lista con las imágenes generadas
Función invocada al llamar a la pipeline para la generación.
Ejemplos:
>>> import torch
>>> from diffusers import LuminaPipeline
>>> pipe = LuminaPipeline.from_pretrained("Alpha-VLLM/Lumina-Next-SFT-diffusers", torch_dtype=torch.bfloat16)
>>> # Enable memory optimizations.
>>> pipe.enable_model_cpu_offload()
>>> prompt = "Upper body of a young woman in a Victorian-era outfit with brass goggles and leather straps. Background shows an industrial revolution cityscape with smoky skies and tall, metal structures"
>>> image = pipe(prompt).images[0]encode_prompt
< source >( prompt: str | list[str]do_classifier_free_guidance: bool = Truenegative_prompt: str | list[str] = Nonenum_images_per_prompt: int = 1device: typing.Optional[torch.device] = Noneprompt_embeds: typing.Optional[torch.Tensor] = Nonenegative_prompt_embeds: typing.Optional[torch.Tensor] = Noneprompt_attention_mask: typing.Optional[torch.Tensor] = Nonenegative_prompt_attention_mask: typing.Optional[torch.Tensor] = Noneclean_caption: bool = False**kwargs )
Parámetros
- prompt (
strolist[str], opcional) — prompt a codificar - negative_prompt (
strolist[str], opcional) — El prompt que no debe guiar la generación de la imagen. Si no se define, hay que pasarnegative_prompt_embedsen su lugar. Se ignora cuando no se usa guía (es decir, se ignora siguidance_scalees menor que1). Para Lumina-T2I, esto debería ser "". - do_classifier_free_guidance (
bool, opcional, valor predeterminadoTrue) — si se debe usar classifier free guidance o no - num_images_per_prompt (
int, opcional, valor predeterminado 1) — número de imágenes que deben generarse por indicación - device — (
torch.device, opcional): dispositivo de torch en el que colocar las incrustaciones resultantes - prompt_embeds (
torch.Tensor, opcional) — Incrustaciones de texto pregeneradas. Se pueden usar para ajustar fácilmente las entradas de texto, p. ej. ponderación de prompts. Si no se proporcionan, las incrustaciones de texto se generarán a partir del argumento de entradaprompt. - negative_prompt_embeds (
torch.Tensor, opcional) — Incrustaciones de texto negativo pregeneradas. Para Lumina-T2I, debe ser la incrustación de la cadena "". - clean_caption (
bool, por defectoFalse) — Si esTrue, la función preprocesará y limpiará la descripción proporcionada antes de codificarla. - max_sequence_length (
int, por defecto 256) — Longitud máxima de la secuencia a utilizar para el prompt.
Codifica el prompt en estados ocultos del codificador de texto.