Diffusers 文档

混元DiT2D模型

Hugging Face's logo
加入 Hugging Face 社区

并获得增强型文档体验

开始使用

HunyuanDiT2DModel

来自 Hunyuan-DiT 的用于 2D 数据的扩散 Transformer 模型。

HunyuanDiT2DModel

class diffusers.HunyuanDiT2DModel

< >

( num_attention_heads: int = 16 attention_head_dim: int = 88 in_channels: Optional = None patch_size: Optional = None activation_fn: str = 'gelu-approximate' sample_size = 32 hidden_size = 1152 num_layers: int = 28 mlp_ratio: float = 4.0 learn_sigma: bool = True cross_attention_dim: int = 1024 norm_type: str = 'layer_norm' cross_attention_dim_t5: int = 2048 pooled_projection_dim: int = 1024 text_len: int = 77 text_len_t5: int = 256 use_style_cond_and_image_meta_size: bool = True )

参数

  • num_attention_heads (int, 可选, 默认值为 16) — 用于多头注意力机制的头数。
  • attention_head_dim (int, 可选, 默认值为 88) — 每个头的通道数。
  • in_channels (int, 可选) — 输入和输出的通道数(如果输入是连续的,请指定)。
  • patch_size (int, 可选) — 用于输入的补丁大小。
  • activation_fn (str, 可选, 默认值为 "geglu") — 前馈层中使用的激活函数。
  • sample_size (int, 可选) — 潜在图像的宽度。 由于它用于学习一定数量的位置嵌入,因此在训练期间保持固定。
  • dropout (float, 可选, 默认值为 0.0) — 使用的丢弃概率。
  • cross_attention_dim (int, 可选) — 剪辑文本嵌入的维度。
  • hidden_size (int, 可选) — 条件嵌入层中隐藏层的尺寸。
  • mlp_ratio (float, 可选, 默认值为 4.0) — 隐藏层大小与输入大小的比率。
  • learn_sigma (bool, 可选, 默认值为 True) — 是否预测方差。
  • cross_attention_dim_t5 (int, 可选) — t5 文本嵌入的维度数。
  • pooled_projection_dim (int, 可选) — 池化投影的大小。
  • text_len (int, 可选) — 剪辑文本嵌入的长度。
  • text_len_t5 (int, 可选) — T5 文本嵌入的长度。
  • use_style_cond_and_image_meta_size (bool, 可选) — 是否使用样式条件和图像元数据大小。 版本 <=1.1 为 True,版本 >= 1.2 为 False。

HunYuanDiT:具有 Transformer 主干的扩散模型。

继承 ModelMixin 和 ConfigMixin 以与 diffusers 的采样器 StableDiffusionPipeline 兼容。

enable_forward_chunking

< >

( chunk_size: Optional = None dim: int = 0 )

参数

  • chunk_size (int, 可选) — 前馈层的块大小。 如果未指定,则将在每个 dim=dim 的张量上分别运行前馈层。
  • dim (int, 可选, 默认值为 0) — 前馈计算应该进行分块的维度。 在 dim=0(批次)或 dim=1(序列长度)之间选择。

将注意力处理器设置为使用 前馈分块

forward

  • hidden_states (torch.Tensor 形状为 (batch size, dim, height, width)) — 输入张量。
  • timestep ( torch.LongTensor, 可选) — 用于指示去噪步骤。
  • encoder_hidden_states ( torch.Tensor 形状为 (batch size, sequence len, embed dims), 可选) — 用于交叉注意力层的条件嵌入。 这是 BertModel 的输出。 text_embedding_mask — torch.Tensor 形状为 (batch, key_tokens) 的注意力掩码将应用于 encoder_hidden_states。 这是 BertModel 的输出。
  • encoder_hidden_states_t5 ( torch.Tensor 形状为 (batch size, sequence len, embed dims), 可选) — 用于交叉注意力层的条件嵌入。 这是 T5 文本编码器的输出。 text_embedding_mask_t5 — torch.Tensor 形状为 (batch, key_tokens) 的注意力掩码将应用于 encoder_hidden_states。 这是 T5 文本编码器的输出。
  • image_meta_size (torch.Tensor) — 条件嵌入指示图像大小 style — torch.Tensor: 条件嵌入指示风格
  • image_rotary_emb (torch.Tensor) — 在注意力计算过程中应用于查询和键张量的图像旋转嵌入。 return_dict — bool 是否返回字典。

HunyuanDiT2DModel 正向方法。

fuse_qkv_projections

< >

( )

启用融合的 QKV 投影。 对于自注意力模块,所有投影矩阵(即查询、键、值)都已融合。 对于交叉注意力模块,键和值投影矩阵已融合。

此 API 🧪 处于实验阶段。

set_attn_processor

< >

( processor: Union )

参数

  • processor (dict of AttentionProcessor or only AttentionProcessor) — 将被设置为所有 Attention 层的处理器的实例化处理器类或处理器类字典。

    如果 processor 是一个字典,键需要定义到相应交叉注意力处理器的路径。强烈建议在设置可训练注意力处理器时使用此方法。

设置用于计算注意力的注意力处理器。

set_default_attn_processor

< >

( )

禁用自定义注意力处理器并设置默认注意力实现。

unfuse_qkv_projections

< >

( )

如果启用,则禁用融合的 QKV 投影。

此 API 🧪 处于实验阶段。

< > 在 GitHub 上更新