Diffusers documentation
EasyAnimateTransformer3DModel
EasyAnimateTransformer3DModel
تم تقديم نموذج EasyAnimate لنموذج Diffusion Transformer للبيانات ثلاثية الأبعاد من Alibaba PAI.
يمكن تحميل النموذج باستخدام مقتطف الشيفرة التالي.
from diffusers import EasyAnimateTransformer3DModel
transformer = EasyAnimateTransformer3DModel.from_pretrained("alibaba-pai/EasyAnimateV5.1-12b-zh", subfolder="transformer", dtype=torch.float16).to("cuda") # or "mps", "xpu", "cpu"EasyAnimateTransformer3DModel
فئة diffusers.EasyAnimateTransformer3DModel
< source >( num_attention_heads: int = 48attention_head_dim: int = 64in_channels: int | None = Noneout_channels: int | None = Nonepatch_size: int | None = Nonesample_width: int = 90sample_height: int = 60activation_fn: str = 'gelu-approximate'timestep_activation_fn: str = 'silu'freq_shift: int = 0num_layers: int = 48mmdit_layers: int = 48dropout: float = 0.0time_embed_dim: int = 512add_norm_text_encoder: bool = Falsetext_embed_dim: int = 3584text_embed_dim_t5: int = Nonenorm_eps: float = 1e-05norm_elementwise_affine: bool = Trueflip_sin_to_cos: bool = Truetime_position_encoding_type: str = '3d_rope'after_norm = Falseresize_inpaint_mask_directly: bool = Trueenable_text_attention_mask: bool = Trueadd_noise_in_inpaint_model: bool = True )
المعاملات
- num_attention_heads (
int، القيمة الافتراضية48) — عدد الرؤوس المستخدمة في الانتباه متعدد الرؤوس. - attention_head_dim (
int، القيمة الافتراضية64) — عدد القنوات في كل رأس. - in_channels (
int)، القيمة الافتراضية16— عدد القنوات في المدخلات. - out_channels (
int، اختياري، القيمة الافتراضية16) — عدد القنوات في المخرجات. - patch_size (
int، القيمة الافتراضية2) — حجم البقع المستخدمة في طبقة تضمين البقع. - sample_width (
int، القيمة الافتراضية90) — عرض الكامنات المدخلة. - sample_height (
int، القيمة الافتراضية60) — ارتفاع الكامنات المدخلة. - activation_fn (
str، القيمة الافتراضية"gelu-approximate") — دالة التنشيط المستخدمة في الشبكة العصبية الأمامية. - timestep_activation_fn (
str، القيمة الافتراضية"silu") — دالة التنشيط المستخدمة عند توليد تضمينات خطوة الزمن. - num_layers (
int، القيمة الافتراضية30) — عدد طبقات كتل Transformer المستخدمة. - mmdit_layers (
int، القيمة الافتراضية1000) — عدد طبقات كتل Multi Modal Transformer المستخدمة. - dropout (
float، القيمة الافتراضية0.0) — احتمالية dropout المستخدمة. - time_embed_dim (
int، القيمة الافتراضية512) — البُعد الناتج لتضمينات خطوات الزمن. - text_embed_dim (
int، القيمة الافتراضية4096) — البُعد المدخل لتضمينات النص من مُشفِّر النص. - norm_eps (
float، القيمة الافتراضية1e-5) — قيمة الإيبسلون المستخدمة في طبقات التطبيع. - norm_elementwise_affine (
bool, defaults toTrue) — Whether to use elementwise affine in normalization layers. - flip_sin_to_cos (
bool، القيمة الافتراضيةTrue) — ما إذا كان يجب عكس sin إلى cos في تضمين الوقت. - time_position_encoding_type (
str)، القيمة الافتراضية3d_rope) — نوع ترميز موضع الزمن. - after_norm (
bool، القيمة الافتراضيةFalse) — علامة لتطبيق التطبيع بعد ذلك. - resize_inpaint_mask_directly (
bool، القيمة الافتراضيةTrue) — علامة لتغيير حجم قناع inpaint مباشرة. - enable_text_attention_mask (
bool، القيمة الافتراضيةTrue) — علامة لتفعيل قناع الانتباه للنص. - add_noise_in_inpaint_model (
bool, defaults toFalse) — Flag to add noise in inpaint model.
نموذج Transformer لبيانات تشبه الفيديو في EasyAnimate.
forward
< source >( hidden_states: Tensortimestep: Tensortimestep_cond: typing.Optional[torch.Tensor] = Noneencoder_hidden_states: typing.Optional[torch.Tensor] = Noneencoder_hidden_states_t5: typing.Optional[torch.Tensor] = Noneinpaint_latents: typing.Optional[torch.Tensor] = Nonecontrol_latents: typing.Optional[torch.Tensor] = Nonereturn_dict: bool = True )
المعاملات
- hidden_states (
torch.Tensorمن الشكل(batch_size, channels, num_frames, height, width)) — مدخلاتhidden_states. - timestep (
torch.LongTensor) — يُستخدم للإشارة إلى خطوة إزالة الضوضاء. - timestep_cond (
torch.Tensor، اختياري) — تضمينات شرطية لخطوة الزمن. إذا تم توفيرها، سيتم جمع التضمينات مع العينات المارة عبر طبقةself.time_embeddingللحصول على تضمينات خطوة الزمن النهائية. - encoder_hidden_states (
torch.Tensor، اختياري) — تضمينات شرطية (تضمينات محسوبة من الشروط المدخلة مثل الأوامر النصية) للاستخدام. - encoder_hidden_states_t5 (
torch.Tensor، اختياري) — تضمينات شرطية إضافية محسوبة من مُشفِّر نصوص T5. - inpaint_latents (
torch.Tensor، اختياري) — كائنات مخفية (Latents) مدمجة معhidden_statesلتنويعات النموذج الخاصة بتعبئة الصور (inpainting). - control_latents (
torch.Tensor، اختياري) — كائنات مخفية (Latents) مدمجة معhidden_statesلتنويعات التحكم في النموذج. - return_dict (
bool، اختياري، القيمة الافتراضيةTrue) — ما إذا كان يجب إرجاع~models.transformer_2d.Transformer2DModelOutputبدلاً من tuple عادي.
طريقة EasyAnimateTransformer3DModel الأمامية.
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.