Diffusers documentation
SkyReelsV2Transformer3DModel
SkyReelsV2Transformer3DModel
تم تقديم نموذج SkyReels-V2، وهو نموذج Diffusion Transformer للبيانات المشابهة للفيديو ثلاثي الأبعاد، من قِبل Skywork AI.
يمكن تحميل النموذج باستخدام مقتطف الشيفرة التالي.
from diffusers import SkyReelsV2Transformer3DModel
transformer = SkyReelsV2Transformer3DModel.from_pretrained("Skywork/SkyReels-V2-DF-1.3B-540P-Diffusers", subfolder="transformer", dtype=torch.bfloat16)SkyReelsV2Transformer3DModel
فئة diffusers.SkyReelsV2Transformer3DModel
< source >( patch_size: tuple = (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)) — أبعاد الباتش ثلاثية الأبعاد لتضمين الفيديو (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 blocks) المستخدمة. - window_size (
tuple[int]، القيمة الافتراضية(-1, -1)) — حجم النافذة للانتباه المحلي (القيمة -1 تشير إلى الانتباه العام). - cross_attn_norm (
bool، القيمة الافتراضيةTrue) — تفعيل تطبيع الانتباه المتقاطع. - qk_norm (
str، اختياري، القيمة الافتراضية"rms_norm_across_heads") — تفعيل تطبيع الاستعلام/المفتاح. - eps (
float، القيمة الافتراضية1e-6) — قيمة إبسيلون لطبقات التطبيع. - inject_sample_info (
bool، القيمة الافتراضيةFalse) — ما إذا كان سيتم حق معلومات العينة في النموذج. - image_dim (
int، اختياري) — بعد تمثيلات الصورة. - added_kv_proj_dim (
int, اختياري) — بعد الإسقاط المضاف للمفتاح/القيمة. - rope_max_seq_len (
int، القيمة الافتراضية1024) — أقصى طول للتسلسل الخاص بالتضمينات الدورانية. - pos_embed_seq_len (
int, اختياري) — طول التسلسل للتضمينات الموضعية.
نموذج Transformer لبيانات تشبه الفيديو، يُستخدم في نموذج SkyReels-V2 المبني على Wan.
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 (
torch.Tensorمن الشكل(batch_size, num_channels, num_frames, height, width)) — مدخلات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) — ما إذا كان سيتم تفعيل إجبار الانتشار (إخفاء سببي لكل كتلة). - fps (
torch.Tensor، اختياري) — تضمين تكييف FPS. - return_dict (
bool، اختياري، القيمة الافتراضيةTrue) — ما إذا كان يجب إرجاع~models.transformer_2d.Transformer2DModelOutputبدلاً من tuple عادي. - attention_kwargs (
dict، اختياري) — قاموس kwargs يُمرَّر إلىAttentionProcessorإذا تم تحديده، كما هو معرَّف تحتself.processorفي diffusers.models.attention_processor.
طريقة SkyReelsV2Transformer3DModel الأمامية.
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.