Diffusers documentation
SkyReelsV2Transformer3DModel
SkyReelsV2Transformer3DModel
Skywork AI 在 SkyReels-V2 中介绍了一种用于 3D 类视频数据的 Diffusion Transformer 模型。
可以使用以下代码片段加载该模型。
from diffusers import SkyReelsV2Transformer3DModel
transformer = SkyReelsV2Transformer3DModel.from_pretrained("Skywork/SkyReels-V2-DF-1.3B-540P-Diffusers", subfolder="transformer", dtype=torch.bfloat16)SkyReelsV2Transformer3DModel
class diffusers.SkyReelsV2Transformer3DModel
< source >( patch_size: tuple[int] = (1, 2, 2)num_attention_heads: int = 16attention_head_dim: int = 128in_channels: int = 16out_channels: int = 16text_dim: int = 4096freq_dim: int = 256ffn_dim: int = 8192num_layers: int = 32cross_attn_norm: bool = Trueqk_norm: str | None = 'rms_norm_across_heads'eps: float = 1e-06image_dim: int | None = Noneadded_kv_proj_dim: int | None = Nonerope_max_seq_len: int = 1024pos_embed_seq_len: int | None = Noneinject_sample_info: bool = Falsenum_frame_per_block: int = 1 )
参数
- patch_size (
tuple[int]，默认为(1, 2, 2)) — 用于视频嵌入的 3D patch 维度 (t_patch, h_patch, w_patch)。 - num_attention_heads (
int，默认为16) — 文本嵌入的固定长度。 - attention_head_dim (
int，默认为128) — 每个头中的通道数。 - in_channels (
int，默认为16) — 输入数据的通道数。 - out_channels (
int，默认为16) — 输出中的通道数。 - text_dim (
int，默认为4096) — 文本嵌入的输入维度。 - freq_dim (
int，默认为256) — 正弦时间嵌入的维度。 - ffn_dim (
int，默认为8192) — 前馈网络中的中间维度。 - num_layers (
int，默认为32) — 要使用的 transformer 块层数。 - window_size (
tuple[int]，默认为(-1, -1)) — 局部注意力的窗口大小（-1 表示全局注意力）。 - cross_attn_norm（
bool，默认为True）— 启用交叉注意力归一化。 - qk_norm (
str，可选，默认为"rms_norm_across_heads") — 启用 query/key 归一化。 - eps (
float，默认为1e-6) — 归一化层的 epsilon 值。 - inject_sample_info（
bool，默认为False） — 是否将样本信息注入模型。 - image_dim (
int, 可选) — 图像嵌入的维度。 - added_kv_proj_dim (
int, 可选) — 新增的 key/value 投影的维度。 - rope_max_seq_len (
int，默认为1024) — 旋转嵌入的最大序列长度。 - pos_embed_seq_len (
int, 可选) — 位置嵌入的序列长度。
用于基于 Wan 的 SkyReels-V2 模型中处理类视频数据的 Transformer 模型。
forward
< source >( hidden_states: Tensortimestep: LongTensorencoder_hidden_states: Tensorencoder_hidden_states_image: typing.Optional[torch.Tensor] = Noneenable_diffusion_forcing: bool = Falsefps: typing.Optional[torch.Tensor] = Nonereturn_dict: bool = Trueattention_kwargs: dict[str, typing.Any] | None = None )
参数
- hidden_states（形状为
(batch_size, num_channels, num_frames, height, width)的torch.Tensor）— 输入的hidden_states。 - timestep (
torch.LongTensor) — 用于指示去噪步骤。 - encoder_hidden_states (
torch.Tensor，形状为(batch_size, sequence_len, embed_dims)) — 要使用的条件嵌入（从输入条件（例如提示词）计算得出的嵌入）。 - encoder_hidden_states_image (
torch.Tensor, 可选) — 用于图像条件生成的条件图像嵌入。 - enable_diffusion_forcing (
bool，可选，默认为False) — 是否启用 diffusion forcing（按块进行因果掩码）。 - fps (
torch.Tensor, 可选) — FPS 条件嵌入。 - return_dict (
bool，可选，默认为True) — 是否返回~models.transformer_2d.Transformer2DModelOutput而不是普通的元组。 - attention_kwargs (
dict, 可选) — 一个 kwargs 字典，如果指定，将传递给 diffusers.models.attention_processor 中定义的AttentionProcessor，该处理器在self.processor下定义。
SkyReelsV2Transformer3DModel 的前向方法。
Transformer2DModelOutput
类 diffusers.models.modeling_outputs.Transformer2DModelOutput
< source >( sample: torch.Tensor )
参数
- sample（形状为
(batch_size, num_channels, height, width)的torch.Tensor，或者如果 Transformer2DModel 是离散的，则为(batch size, num_vector_embeds - 1, num_latent_pixels)）— 以encoder_hidden_states输入为条件的隐藏状态输出。如果是离散的，则返回未加噪潜在像素的概率分布。
Transformer2DModel 的输出。