- ae.safetensors هو ملف أوزان VAE (المرسل التلقائي المتغير) المرفق مع نماذج الصور FLUX.1 من Black Forest Labs. ويُستخدم لفك تشفير القيم الكامنة (latents) التي يولدها FLUX إلى بكسلات RGB، وكذلك لتشفير الصور مرة أخرى إلى قيم كامنة لمهام img2img.
- نزِّله من الصفحة الرسمية على safetensors" rel="noopener" target="_blank">black-forest-labs/FLUX.1-schnell أو FLUX.1-dev في مستودعات Hugging Face. وحجم الملف نحو 335 ميغابايت.
- في ComfyUI، ضعه في المجلد
ComfyUI/models/vae/وحمّله باستخدام عقدة Load VAE وفي Forge/A1111، ضعه في المجلدmodels/VAE/. - نفس ملف
ae.safetensorsيعمل مع كل من FLUX.1-dev وFLUX.1-schnell ومعظم إصدارات FLUX المُعدَّلة (finetunes) — فلا حاجة إلى ملف VAE منفصل لكل نقطة تحقق (checkpoint).
ae.safetensors هو ملف أوزان المرسل التلقائي (VAE) المرفق مع نماذج الانتشار (diffusion) FLUX.1 من Black Forest Labs. ويولد FLUX الصور في فضاء كامن مضغوط؛ ae.safetensors هو جزء فك التشفير الذي يحوّل تلك القيم الكامنة إلى بكسلات مرئية (وهو أيضًا الجزء المسؤول عن التشفير في مهام image-to-image والتعديل الجزئي للصور «inpainting»). ومن دون هذا الملف، لا تستطيع أدوات مثل ComfyUI أو Forge أو SwarmUI أو مكتبة diffusers إنتاج صورة نهائية من نقطة تحقق FLUX.
يُخزَّن الملف بصيغة safetensors safetensors — وهي حاوية تحتوي على التنسورات فقط وقابلة للربط المباشر بالذاكرة (memory-mappable)، ولا تنفّذ أي كود بايثون عشوائي عند التحميل، على عكس ملفات .ckpt التقليدية المبنية على pickle. ولذلك فإن معظم الإصدارات الحديثة للنماذج تنشر أوزانها بصيغة .safetensors.
ما المحتوى الدقيق لملف ae.safetensors؟
FLUX.1 هو نموذج تحويلي (transformer) يعمل وفق آلية التدفق المصحح (rectified-flow)، ويعمل على قيم كامنة ذات 16 قناة وبدقة مكانية تبلغ 1/8 من الدقة الأصلية. أما ملف ae.safetensors فيحتوي فقط على أوزان VAE — بدون أي مكوّنات تحويلية (transformer)، ولا مشفرات نصية (text encoders). والمواصفات التقريبية هي:
| الخاصية | القيمة |
|---|---|
| حجم الملف | ~335 ميغابايت (بتنسيق fp16) |
| عدد القنوات الكامنة | 16 |
| الضغط المكاني | 8× (أي أن صورة مقاس 1024×1024 تتحول إلى قيمة كامنة مقاس 128×128×16) |
| الصيغة | safetensors (تنسورات فقط، بدون pickle) |
| نقاط التحقق المتوافقة | FLUX.1-dev، FLUX.1-schnell، FLUX.1-pro (عبر API)، ومعظم إصدارات FLUX المُعدَّلة (finetunes) وملفات LoRAs |
| الترخيص | رخصة الاستخدام غير التجاري لملف VAE الخاص بـ FLUX.1-dev؛ ورخصة Apache-2.0 لملف VAE الخاص بـ FLUX.1-schnell |
إن VAE الخاص بـ FLUX ليس نفس ملف VAE الخاص بـ SD 1.5 أو SDXL. ففضاء القيم الكامنة ذي القنوات الـ16 غير متوافق مع تلك النماذج — لذا لا تحاول استبدالها ببعضها.
أين يمكن تنزيل ملف ae.safetensors؟
احصل عليه من المستودعات الرسمية لـ Black Forest Labs على Hugging Face. وكلا الملفين مبنيان على نفس البنية المعمارية؛ لكن مستودع FLUX.1-schnell مرخّص برخصة Apache-2.0 ويمكن إعادة توزيعه بحرية، ولذلك تشير معظم الحزم الخارجية إليه.
- black-forest-labs/FLUX.1-schnell → ae.safetensors (برخصة Apache-2.0)
- black-forest-labs/FLUX.1-dev → ae.safetensors (برخصة FLUX.1-dev غير التجارية؛ وتتطلب الموافقة على شرط الوصول «gate»)
تنزيله عبر سطر الأوامر باستخدام أداة Hugging Face CLI:
pip install -U "huggingface_hub[cli]"
huggingface-cli login # مطلوب فقط للوصول إلى FLUX.1-dev المقيد
huggingface-cli download black-forest-labs/FLUX.1-schnell ae.safetensors --local-dir .تحقق من تجزئة SHA-256 مقابل القيمة المعروضة على صفحة الملف في Hugging Face قبل استخدامه.
تثبيت ملف ae.safetensors حسب الأداة المستخدمة
ComfyUI (لنظامي Windows وmacOS وLinux)
ComfyUI هو واجهة المستخدم المرجعية الخاصة بـ FLUX. ضع الملف في مجلد VAE كما يلي:
# Linux / macOS
mv ae.safetensors ~/ComfyUI/models/vae/
# Windows (PowerShell)
Move-Item .\ae.safetensors $HOME\ComfyUI\models\vaeفي الرسم البياني (graph)، أضف عقدة Load VAE واختر ae.safetensors من القائمة المنسدلة، ثم وصّل مخرجاتها VAE المخرجات إلى فك تشفير VAE العقدة الموجودة قبل عقدة حفظ الصورة العقدة. إذا كنت تستخدم ملف التحقق المدمج بالكامل من FLUX (الوزن + VAE + مشفرات النصوص في ملف واحد) من Comfy-Org، فلن تحتاج إلى ae.safetensors بشكل منفصل — فقد تم دمج VAE داخل الملف.
Forge / Automatic1111 / reForge
ضع الملف في stable-diffusion-webui-forge/models/VAE/ (يكتشف Forge الملف تلقائيًا). وفي واجهة مستخدم Forge، اضبط وضع UI على flux، ثم في مُحدِّد VAE / مشفر النصوص في الأعلى، اختر ae.safetensors إلى جانب مشفِّرَي CLIP-L وT5-XXL. لا يدعم Automatic1111 العادي رسميًّا FLUX؛ لذا استخدم Forge بدلًا منه.
SwarmUI / StableSwarmUI
أنزل الملف في مجلد Models/VAE/. ويكتشف Swarm تلقائيًّا ملفات التحقق المتوافقة مع FLUX وسيختار ae.safetensors تلقائيًّا إذا كان هذا الملف الوحيد المتوافق مع FLUX والمتوفر حاليًّا.
diffusers (بايثون)
إذا كنت تقوم بتحميل المستودع الكامل لـ FLUX من Hugging Face، فإن VAE مضمَّنٌ ضمنه ولن تحتاج إلى التعامل مع ae.safetensors بشكل مباشر. ولتحميل ملف ae.safetensors:
from diffusers import AutoencoderKL, FluxPipeline
import torch
vae = AutoencoderKL.from_single_file(
"ae.safetensors", torch_dtype=torch.bfloat16
)
pipe = FluxPipeline.from_pretrained(
"black-forest-labs/FLUX.1-schnell",
vae=vae,
torch_dtype=torch.bfloat16,
).to("cuda")راجع وثائق أحدث إصدار من خط أنابيب FLUX في diffusers — إذ تغيَّر اسم الفئة الدقيق لـ VAE الخاص بـ FLUX بين إصدارات diffusers، لذا يُفضَّل تثبيت الإصدار الذي تستخدمه.
ملاحظات حول استهلاك الـ VRAM والأداء
إن وحدة VAE نفسها صغيرة جدًّا (~335 ميغابايت بصيغة fp16، و~168 ميغابايت بصيغة fp8) — وهي ليست السبب في ثقل نموذج FLUX. بل إن المحول (transformer) هو العامل الرئيسي في استهلاك الموارد: فحجم FLUX.1-dev يبلغ نحو 23 غيغابايت بصيغة bf16 ونحو 12 غيغابايت بصيغة fp8. وعلى بطاقات الرسوميات ذات سعة 24 غيغابايت (مثل RTX 3090/4090)، يمكنك تشغيل FLUX مع بقاء VAE في الذاكرة المخصصة للوحدة الرسومية؛ أما على البطاقات ذات سعة 12 غيغابايت، فعادةً ما يتم نقل VAE مؤقتًا إلى وحدة المعالجة المركزية بين عمليات فك التشفير.
لمعرفة عامة عن كمية ذاكرة وحدة معالجة الرسومات (VRAM) التي تستهلكها نماذج الانتشار (diffusion) ونماذج النماذج اللغوية الكبيرة (LLM)، استخدم حاسبة VRAM من Convly والـ أفضل وحدات معالجة الرسوميات للنماذج المحلية دليل.
فك التشفير بدقة عالية
يصل استهلاك وحدة VAE الخاصة بـ FLUX من ذاكرة VRAM إلى الذروة أثناء مرحلة فك التشفير، وتتناسب هذه الذروة طرديًّا مع دقة الصورة الناتجة. ففك تشفير صورة بدقة 2048×2048 يتطلب تقريبًا أربعة أضعاف ذروة الاستهلاك مقارنةً بفك تشفير صورة بدقة 1024×1024. وإذا واجهتك رسالة خطأ تشير إلى نفاد الذاكرة (OOM) فقط في خطوة فك التشفير النهائية، ففعِّل خاصية VAE المُقسَّمة (tiled VAE):
- ComfyUI: استبدل عقدة فك تشفير VAE مع فك تشفير VAE (مُقسَّمة).
- diffusers:
pipe.vae.enable_tiling()قبل بدء الاستنتاج. - Forge: فعِّل خانة الاختيار VAE مُقسَّمة في لوحة الإعدادات.
الأخطاء الشائعة المتعلقة بملف ae.safetensors
| خطأ | السبب | إصلاح |
|---|---|---|
خطأ أثناء فك تسلسل رأس الملف: HeaderTooLarge |
تم تنزيل الملف بشكل غير كامل | أعد التنزيل وتحقق من قيمة SHA-256 |
| صورة خرج باللونين الأسود والأخضر | VAE خاطئة (تم تحميل VAE الخاص بـ SDXL لنموذج FLUX) | تأكد من أن ae.safetensors مُحدَّدٌ، وليس sdxl_vae.safetensors |
مفتاح أو أكثر مفقود في state_dict |
محاولة تحميل VAE الخاص بـ FLUX في خط أنابيب SD 1.5 أو SDXL | الاستخدام FluxPipeline/AutoencoderKL.from_single_filemodel-index StableDiffusionPipeline |
| الملف حجمه 335 ميغابايت لكنه رُفض باعتباره غير صالح | تم تنزيل صفحة بوابة HTML بدلًا من الملف | اقبل الترخيص في صفحة النموذج أو استخدم huggingface-cli مع رمز |
مقارنة بين ملف ae.safetensors وملف FLUX الكامل المدمج (All-in-One)
سترى نمطين لتوزيع الملفات على Hugging Face وCivitai:
- ملفات مقسَّمة (التنسيق الرسمي من BFL):
flux1-dev.safetensors(المُحوِّل) +ae.safetensors(VAE) +clip_l.safetensors+t5xxl_fp16.safetensors. يُفضَّل استخدامه مع مكتبة diffusers، والرسوم البيانية المتقدمة في ComfyUI، وضبط النموذج الدقيق — ويمكنك استبدال المُحوِّل دون الحاجة لإعادة تنزيل ٢٠ جيجابايت من مشفرات النصوص. - ملف واحد شامل (إعادة تغليف من قِبل Comfy-Org، مثل:
flux1-dev-fp8.safetensors): حيث يتم تجميع جميع المكوِّنات في ملف واحد. وهذا أبسط لسير عمل ComfyUI بنقرة واحدة؛ ولا تحتاج إلىae.safetensorsكملف منفصل.
أين يقع FLUX في المشهد الأوسع لنماذج الذكاء الاصطناعي؟
يُعَدّ FLUX نموذج صور محليًا ذاتي الاستضافة. فإذا كنت تختار بين تشغيله على وحدة معالجة الرسومات (GPU) الخاصة بك أو استدعاء واجهة برمجية (API) مستضافة للصور أو الفيديو — Sora 2, Veo 3.1, Kling 2.5، Wan 2.5 — فإن المفاضلة هنا هي بين تكلفة الأجهزة الثابتة مقابل الفوترة حسب الثانية. راجع حاسبة نقطة التعادل بين الاستضافة المحلية وواجهة برمجة التطبيقات (API) لتقييم النقطة التي تصبح فيها التكلفة متكافئة، وراجع Convly لمعرفة أسعار الواجهات البرمجية الحالية عبر مختلف الموفِّرين.
أما بالنسبة لنماذج النصوص، فلا تنطبق تقسيمات الملفات المشابهة لـ VAE — إذ تُوزَّع نماذج اللغة الكبيرة (LLMs) فقط بوزن المُحوِّل. وإذا كنت تشغل أيضًا نماذج لغوية كبيرة محلية جنبًا إلى جنب مع FLUX، فإن أدوات مثل Ollama و LM Studio تتولى إدارة النماذج بنفس الطريقة التي تتولى بها ComfyUI إدارة أصول الانتشار (diffusion assets).
الأسئلة الشائعة
هل ملف ae.safetensors هو نفسه المستخدم مع كل من FLUX.1-dev وFLUX.1-schnell؟
نعم — فبنية VAE وأوزانها متطابقة تمامًا بين FLUX.1-dev وFLUX.1-schnell. وتضمّن المستودعان نفس ae.safetensors، لكن تحت رخص مختلفة (رخصة schnell هي Apache-2.0، بينما رخصة dev غير تجارية). ويمكنك استخدام أي من النسختين بالتبادل.
هل يمكنني استخدام VAE نموذج SDXL مع FLUX لتوفير الـ VRAM؟
لا. يستخدم FLUX فضاءً كامنًا (latent space) مكوَّنًا من ١٦ قناة، بينما يستخدم SDXL فضاءً مكوَّنًا من ٤ قنوات. ويؤدي تحميل VAE الخاص بـ SDXL على بيانات كامنة من FLUX إلى إخراج صور بلون ثابت أو ضوضاء، كما أن مكتبة diffusers عادةً ما تُظهر خطأً بسبب عدم تطابق الأشكال. استخدم ae.safetensors.
هل يُعتبر تنزيل ملف ae.safetensors من جهات خارجية آمنًا؟
إن تنسيق safetensors نفسه لا يمكنه تنفيذ أي كود عند التحميل، وبالتالي لا يمكن لملف تالف أو خبيث اختراق جهازك بالطريقة التي قد يفعلها ملف مُشفَّر باستخدام pickle .ckpt . ومع ذلك، فقد يؤدي VAE مُعدَّل بشكل خاطئ إلى إنتاج صور منخفضة الجودة. ومن الأفضل الاعتماد على المستودعات الرسمية لشركة Black Forest Labs والتحقق من تجزئة SHA-256.
هل أحتاج إلى ملف ae.safetensors إذا كنت أستخدم FLUX فقط عبر واجهة برمجة التطبيقات (API)؟
لا. تعمل واجهات البرمجة API المستضافة (مثل Replicate وfal.ai وواجهة BFL الخاصة وTogether) على تشغيل كامل سير العمل على الخادم. وأنت تحتاج فقط إلى ae.safetensors عند تشغيل FLUX محليًا باستخدام ComfyUI أو Forge أو SwarmUI أو diffusers.
لماذا سُمي الملف بـ «ae» بدلًا من «vae»؟
يستخدم التسمية الداخلية لشركة Black Forest Labs مصطلح «ae» (المرشِّح الذاتي) بدلًا من التسمية الأكثر شيوعًا «vae» المستخدمة في نظام Stable Diffusion. ووظيفيًّا، يؤدي هذا العنصر نفس الدور: ترميز البكسل إلى بيانات كامنة وفك ترميز البيانات الكامنة مرة أخرى إلى بكسل. وتقنيًّا، يشبه مرشِّح FLUX الذاتي أكثر ما يشبه مرشِّحًا ذاتيًا بسيطًا منتظمًا بواسطة KL مقارنةً بـ VAE الخاص بـ SD 1.5، لكن كل واجهات المستخدم تعامله على أنه VAE.
هل يمكنني ضبط ملف ae.safetensors تدريجيًّا (finetune)؟
يمكنك فعل ذلك، لكنه نادرًا ما يكون مفيدًا. فقد تم تدريب VAE على مليارات الصور، وغالبًا ما يؤدي ضبطه الدقيق إلى تدهور توافق المُحوِّل مع الفضاء الكامن، مما يضر بالجودة. أما التعديلات المجتمعية على FLUX وملفات LoRAs فهي تُجري التعديل فقط على المُحوِّل وتُعيد استخدام VAE القياسي. ae.safetensors.