Diffusers documentation

Удалённый вывод

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Удалённый вывод

Remote inference обеспечивает доступ к Inference Endpoint для переноса локальных задач генерации, декодирования и кодирования.

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 Hybrid Inference, позволяющий выполнять декодирование 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 Hybrid Inference, позволяющий выполнять кодирование VAE удаленно.

Update on GitHub