Diffusers documentation
CogView3PlusTransformer2DModel
CogView3PlusTransformer2DModel
Модель Diffusion Transformer для 2D-данных из CogView3Plus была представлена в работе CogView3: Finer and Faster Text-to-Image Generation via Relay Diffusion от Tsinghua University & ZhipuAI.
Модель можно загрузить с помощью следующего фрагмента кода.
from diffusers import CogView3PlusTransformer2DModel
transformer = CogView3PlusTransformer2DModel.from_pretrained("THUDM/CogView3Plus-3b", subfolder="transformer", dtype=torch.bfloat16).to("cuda") # or "mps", "xpu", "cpu"CogView3PlusTransformer2DModel
класс diffusers.CogView3PlusTransformer2DModel
< source >( patch_size: int = 2in_channels: int = 16num_layers: int = 30attention_head_dim: int = 40num_attention_heads: int = 64out_channels: int = 16text_embed_dim: int = 4096time_embed_dim: int = 512condition_dim: int = 256pos_embed_max_size: int = 128sample_size: int = 128 )
Параметры
- patch_size (
int, по умолчанию2) — Размер патчей, используемых в слое встраивания патчей. - in_channels (
int, по умолчанию16) — Количество каналов на входе. - num_layers (
int, по умолчанию30) — Количество блоков Transformer, используемых в модели. - attention_head_dim (
int, по умолчанию40) — Количество каналов в каждой голове. - num_attention_heads (
int, по умолчанию64) — Количество голов, используемых для многоголовного внимания. - out_channels (
int, по умолчанию16) — Количество каналов на выходе. - text_embed_dim (
int, по умолчанию4096) — Входное измерение текстовых эмбеддингов от текстового энкодера. - time_embed_dim (
int, по умолчанию512) — Размерность выходного вектора эмбеддингов временных шагов. - condition_dim (
int, по умолчанию256) — Размерность эмбеддинга для входных условий разрешения в стиле SDXL (original_size, target_size, crop_coords). - pos_embed_max_size (
int, по умолчанию128) — Максимальное разрешение позиционных эмбеддингов, из которого берутся срезы формыH x Wи добавляются к входным патчеванным латентам, гдеHиW— высота и ширина латентов соответственно. Значение 128 означает, что максимальная поддерживаемая высота и ширина для генерации изображений равны128 * vae_scale_factor * patch_size => 128 * 8 * 2 => 2048. - sample_size (
int, по умолчанию128) — Базовое разрешение входных латентов. Если при генерации не указаны высота/ширина, это значение используется для определения разрешения какsample_size * vae_scale_factor => 128 * 8 => 1024
The Transformer model introduced in CogView3: Finer and Faster Text-to-Image Generation via Relay Diffusion.
forward
< source >( hidden_states: Tensorencoder_hidden_states: Tensortimestep: LongTensororiginal_size: Tensortarget_size: Tensorcrop_coords: Tensorreturn_dict: bool = True ) → torch.Tensor or ~models.transformer_2d.Transformer2DModelOutput
Параметры
- hidden_states (
torch.Tensor) — Входныеhidden_statesформы(batch size, channel, height, width). - encoder_hidden_states (
torch.Tensor) — Условные эмбеддинги (эмбеддинги, вычисленные на основе входных условий, таких как промпты) формы(batch_size, sequence_len, text_embed_dim) - timestep (
torch.LongTensor) — Используется для указания шага денойзинга. - original_size (
torch.Tensor) — CogView3 использует микроусловия, аналогичные SDXL, для исходного размера изображения, как описано в разделе 2.2 https://huggingface.co/papers/2307.01952. - target_size (
torch.Tensor) — CogView3 использует микроусловия, аналогичные SDXL, для размера целевого изображения, как описано в разделе 2.2 https://huggingface.co/papers/2307.01952. - crop_coords (
torch.Tensor) — CogView3 использует микроусловия для координат обрезки, аналогичные SDXL, как описано в разделе 2.2 статьи https://huggingface.co/papers/2307.01952. - return_dict (
bool, необязательный, по умолчаниюTrue) — Определяет, следует ли возвращать~models.transformer_2d.Transformer2DModelOutputвместо обычного кортежа.
Возвращает
torch.Tensor или ~models.transformer_2d.Transformer2DModelOutput
Шумоподавленные латенты, использующие предоставленные входные данные в качестве условия.
Метод forward модели CogView3PlusTransformer2DModel.
Transformer2DModelOutput
класс diffusers.models.modeling_outputs.Transformer2DModelOutput
< source >( sample: torch.Tensor )
Параметры
- sample (
torch.Tensorформы(batch_size, num_channels, height, width)или(batch size, num_vector_embeds - 1, num_latent_pixels), если Transformer2DModel дискретный) — Выходные скрытые состояния, обусловленные входомencoder_hidden_states. Если модель дискретная, возвращает распределения вероятностей для латентных пикселей без шума.
Вывод Transformer2DModel.