Diffusers documentation

الاستدلال عن بُعد

You are viewing main version, which requires installation from source. If you'd like regular pip install, checkout the latest stable version (v0.43.0).
Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

الاستدلال عن بُعد

توفر الاستدلال عن بُعد وصولاً إلى نقطة نهاية الاستدلال لتفريغ متطلبات التوليد المحلية الخاصة بفك الترميز وترميزه.

remote_decode

diffusers.utils.remote_decode

< >

( endpoint: strtensor: 'torch.Tensor'processor: 'VaeImageProcessor' | 'VideoProcessor' | None = Nonedo_scaling: bool = Truescaling_factor: float | None = Noneshift_factor: float | None = Noneoutput_type: Literal['mp4', 'pil', 'pt'] = 'pil'return_type: Literal['mp4', 'pil', 'pt'] = 'pil'image_format: Literal['png', 'jpg'] = 'jpg'partial_postprocess: bool = Falseinput_tensor_type: Literal['binary'] = 'binary'output_tensor_type: Literal['binary'] = 'binary'height: int | None = Nonewidth: int | None = None )

المعاملات

  • endpoint (str) — نقطة النهاية لـ Remote Decode.
  • tensor (torch.Tensor) — المصفوفة المراد فك ترميزها.
  • processor (VaeImageProcessor أو VideoProcessor، اختياري) — يُستخدم مع return_type="pt"، ومع return_type="pil" لنماذج الفيديو.
  • do_scaling (bool)، الافتراضي True، اختياري — مُتقادم. مرّر scaling_factor/shift_factor بدلاً من ذلك. لا يزال من الممكن تعيين do_scaling=None/do_scaling=False لعدم تطبيق أي توسيع حتى يتم إزالة الخيار عند تعيين True، يُطبَّق التوسيع عن بُعد، على سبيل المثال latents / self.vae.config.scaling_factor. أما إذا كان False، فيجب تمرير المدخلات مع تطبيق التوسيع مسبقاً.
  • scaling_factor (float, اختياري) — يُطبَّق التوسيع عند تمرير المعامل، على سبيل المثال latents / self.vae.config.scaling_factor.
    • SD v1: 0.18215
    • SD XL: 0.13025
    • Flux: 0.3611 إذا كانت None، فيجب تمرير المدخلات مع تطبيق التوسيع.
  • shift_factor (float, اختياري) — يُطبَّق الإزاحة عند تمريرها، على سبيل المثال latents + self.vae.config.shift_factor.
    • Flux: 0.1159 إذا كانت None، فيجب تمرير المدخل مع تطبيق التوسيع.
  • output_type ("mp4" أو "pil" أو "pt", default “) — نوع الإخراج. خاضع للتغيير. يُرجى الإبلاغ عن الملاحظات حول النوع المفضل.

    "mp4": Supported by video models. Endpoint returns bytesof video.“pil”: Supported by image and video models. Image models: Endpoint returns bytesof an image inimage_format. Video models: Endpoint returns torch.Tensorwith partialpostprocessingapplied. Requiresprocessoras a flag (anyNonevalue will work).“pt”: Support by image and video models. Endpoint returns torch.Tensor. With partial_postprocess=Truethe tensor is postprocesseduint8` image tensor.

    التوصيات: "pt" مع partial_postprocess=True هو أصغر حجم نقل لجودة كاملة. "pt" مع partial_postprocess=False هو الأكثر توافقاً مع أكواد الأطراف الثالثة. "pil" مع image_format="jpg" هو أصغر حجم نقل بشكل عام.

  • return_type ("mp4" أو "pil" أو "pt", default “— نوع إرجاع الدالة.

    "mp4": Function returns bytesof video.“pil”: Function returns PIL.Image.Image. With output_type=“pil” no further processing is applied. With output_type="pt" a PIL.Image.Imageis created.partial_postprocess=False processoris required.partial_postprocess=True processoris **not** required.“pt”: Function returns torch.Tensor. processoris **not** required.partial_postprocess=Falsetensor isfloat16orbfloat16, without denormalization. partial_postprocess=Truetensor isuint8`, denormalized.

  • image_format ("png" أو "jpg"، الافتراضي jpg) — يُستخدم مع output_type="pil". يعيد نقطة النهاية jpg أو png.
  • partial_postprocess (bool، الافتراضي False) — يُستخدم مع output_type="pt". عندما يكون partial_postprocess=False تكون المصفوفة float16 أو bfloat16، دون إزالة التطبيع. عندما يكون partial_postprocess=True تكون المصفوفة uint8، مع إزالة التطبيع.
  • input_tensor_type ("binary"، الافتراضي "binary") — نوع نقل المصفوفة.
  • output_tensor_type ("binary"، الافتراضي "binary") — نوع نقل المصفوفة.
  • height (int، اختياري) — مطلوب لـ"packed" الكامنة.
  • width (int، اختياري) — مطلوب لـ"packed" الكامنة.

استدلال هجين من Hugging Face يتيح تشغيل فك ترميز VAE عن بُعد.

remote_encode

diffusers.utils.remote_utils.remote_encode

< >

( endpoint: strimage: 'torch.Tensor' | Image.Imagescaling_factor: float | None = Noneshift_factor: float | None = None )

المعاملات

  • endpoint (str) — نقطة النهاية لـ Remote Decode.
  • image (torch.Tensor أو PIL.Image.Image) — الصورة المراد ترميزها.
  • scaling_factor (float, اختياري) — يُطبَّق التوسيع عند تمرير المعامل، على سبيل المثال latents * self.vae.config.scaling_factor.
    • SD v1: 0.18215
    • SD XL: 0.13025
    • Flux: 0.3611 إذا كانت None، فيجب تمرير المدخلات مع تطبيق التوسيع.
  • shift_factor (float, اختياري) — يُطبَّق الإزاحة عند تمريرها، على سبيل المثال latents - self.vae.config.shift_factor.
    • Flux: 0.1159 إذا كانت None، فيجب تمرير المدخل مع تطبيق التوسيع.

استدلال هجين من Hugging Face يتيح تشغيل ترميز VAE عن بُعد.

Update on GitHub