Diffusers documentation
Удалённый вывод
Удалённый вывод
Remote inference обеспечивает доступ к Inference Endpoint для переноса локальных задач генерации, декодирования и кодирования.
remote_decode
diffusers.utils.remote_decode
< source >( 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, входные данные должны быть переданы с уже примененным масштабированием.
- Flux: 0.1159
Если
- output_type (
"mp4"или"pil"или"pt", default“) — Тип вывода. Может быть изменён. Сообщите о предпочтительном типе."mp4": Supported by video models. Endpoint returnsbytesof video.“pil”: Supported by image and video models. Image models: Endpoint returnsbytesof an image inimage_format. Video models: Endpoint returnstorch.Tensorwith partialpostprocessingapplied. Requiresprocessoras a flag (anyNonevalue will work).“pt”: Support by image and video models. Endpoint returnstorch.Tensor. Withpartial_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 returnsbytesof video.“pil”: Function returnsPIL.Image.Image. Withoutput_type=“pil” no further processing is applied. Withoutput_type="pt" aPIL.Image.Imageis created.partial_postprocess=Falseprocessoris required.partial_postprocess=Trueprocessoris **not** required.“pt”: Function returnstorch.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
< source >( 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, входные данные должны быть переданы с уже примененным масштабированием.
- Flux: 0.1159
Если
Hugging Face Hybrid Inference, позволяющий выполнять кодирование VAE удаленно.