Buckets:
| # Archivos individuales | |
| El método [from_single_file()](/docs/diffusers/v0.43.0/es/api/loaders/single_file#diffusers.loaders.FromSingleFileMixin.from_single_file) permite cargar: | |
| * un modelo almacenado en un solo archivo, que es útil si trabajas con modelos del ecosistema de difusión, como Automatic1111, y dependes comúnmente de un esquema de un solo archivo para almacenar y compartir modelos | |
| * un modelo almacenado en su distribución original, que es útil si estás trabajando con modelos afinados con otros servicios y deseas cargarlo directamente en objetos de modelo y pipelines de Diffusers | |
| > [!TIP] | |
| > Lea la guía [Archivos y estructuras de modelos](../../using-diffusers/other-formats) para obtener más información sobre la estructura de Diffusers-multifolder frente a la estructura de archivo único, y cómo cargar modelos almacenados en estas diferentes estructuras. | |
| ## Pipelines admitidos | |
| - [StableDiffusionPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/stable_diffusion/text2img#diffusers.StableDiffusionPipeline) | |
| - [StableDiffusionImg2ImgPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/stable_diffusion/img2img#diffusers.StableDiffusionImg2ImgPipeline) | |
| - [StableDiffusionInpaintPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/stable_diffusion/inpaint#diffusers.StableDiffusionInpaintPipeline) | |
| - [StableDiffusionControlNetPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/controlnet#diffusers.StableDiffusionControlNetPipeline) | |
| - [StableDiffusionControlNetImg2ImgPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/controlnet#diffusers.StableDiffusionControlNetImg2ImgPipeline) | |
| - [StableDiffusionControlNetInpaintPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/controlnet#diffusers.StableDiffusionControlNetInpaintPipeline) | |
| - [StableDiffusionUpscalePipeline](/docs/diffusers/v0.43.0/es/api/pipelines/stable_diffusion/upscale#diffusers.StableDiffusionUpscalePipeline) | |
| - [StableDiffusionXLPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/stable_diffusion/stable_diffusion_xl#diffusers.StableDiffusionXLPipeline) | |
| - [StableDiffusionXLImg2ImgPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/stable_diffusion/stable_diffusion_xl#diffusers.StableDiffusionXLImg2ImgPipeline) | |
| - [StableDiffusionXLInpaintPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/stable_diffusion/stable_diffusion_xl#diffusers.StableDiffusionXLInpaintPipeline) | |
| - [StableDiffusionXLInstructPix2PixPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/pix2pix#diffusers.StableDiffusionXLInstructPix2PixPipeline) | |
| - [StableDiffusionXLControlNetPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/controlnet_sdxl#diffusers.StableDiffusionXLControlNetPipeline) | |
| - `StableDiffusionXLKDiffusionPipeline` | |
| - [StableDiffusion3Pipeline](/docs/diffusers/v0.43.0/es/api/pipelines/stable_diffusion/stable_diffusion_3#diffusers.StableDiffusion3Pipeline) | |
| - [LatentConsistencyModelPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/latent_consistency_models#diffusers.LatentConsistencyModelPipeline) | |
| - [LatentConsistencyModelImg2ImgPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/latent_consistency_models#diffusers.LatentConsistencyModelImg2ImgPipeline) | |
| - `StableDiffusionControlNetXSPipeline` | |
| - `StableDiffusionXLControlNetXSPipeline` | |
| - [LEditsPPPipelineStableDiffusion](/docs/diffusers/v0.43.0/es/api/pipelines/ledits_pp#diffusers.LEditsPPPipelineStableDiffusion) | |
| - [LEditsPPPipelineStableDiffusionXL](/docs/diffusers/v0.43.0/es/api/pipelines/ledits_pp#diffusers.LEditsPPPipelineStableDiffusionXL) | |
| - `PIAPipeline` | |
| ## Modelos compatibles | |
| - [UNet2DConditionModel](/docs/diffusers/v0.43.0/es/api/models/unet2d-cond#diffusers.UNet2DConditionModel) | |
| - `StableCascadeUNet` | |
| - [AutoencoderKL](/docs/diffusers/v0.43.0/es/api/models/autoencoderkl#diffusers.AutoencoderKL) | |
| - [ControlNetModel](/docs/diffusers/v0.43.0/es/api/models/controlnet#diffusers.ControlNetModel) | |
| - [SD3Transformer2DModel](/docs/diffusers/v0.43.0/es/api/models/sd3_transformer2d#diffusers.SD3Transformer2DModel) | |
| - [FluxTransformer2DModel](/docs/diffusers/v0.43.0/es/api/models/flux_transformer#diffusers.FluxTransformer2DModel) | |
| ## FromSingleFileMixin[[diffusers.loaders.FromSingleFileMixin]] | |
| #### diffusers.loaders.FromSingleFileMixin[[diffusers.loaders.FromSingleFileMixin]] | |
| ```python | |
| diffusers.loaders.FromSingleFileMixin() | |
| ``` | |
| [Fuente](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/loaders/single_file.py#L243) | |
| Cargue los pesos del modelo guardados en el formato `.ckpt` en un [DiffusionPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/overview#diffusers.DiffusionPipeline). | |
| #### from_single_file[[diffusers.loaders.FromSingleFileMixin.from_single_file]] | |
| ```python | |
| from_single_file(pretrained_model_link_or_path, **kwargs) | |
| ``` | |
| [Fuente](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/loaders/single_file.py#L248) | |
| **Parámetros:** | |
| pretrained_model_link_or_path (`str` o `os.PathLike`, *opcional*) : Puede ser: - Un enlace al archivo `.ckpt` (por ejemplo, `"https://huggingface.co/<repo_id>/blob/main/<path_to_file>.ckpt"`) en el Hub. - Una ruta a un *archivo* que contiene todos los pesos del pipeline. | |
| dtype (`str` o `torch.dtype`, *opcional*) : Anula el `torch.dtype` predeterminado y carga el modelo con otro dtype. | |
| force_download (`bool`, *opcional*, valor predeterminado `False`) : Indica si se debe forzar la (re)descarga de los pesos del modelo y los archivos de configuración, reemplazando las versiones en caché si existen. | |
| cache_dir (`str | os.PathLike`, *opcional*) : Ruta a un directorio donde se almacena en caché la configuración de un modelo preentrenado descargado si no se utiliza la caché estándar. | |
| proxies (`dict[str, str]`, *opcional*) : Un diccionario de servidores proxy a utilizar por protocolo o punto de acceso, por ejemplo, `{'http': 'foo.bar:3128', 'http://hostname': 'foo.bar:4012'}`. Los proxies se utilizan en cada solicitud. | |
| local_files_only (`bool`, *opcional*, valor predeterminado `False`) : Indica si se deben cargar únicamente los pesos y archivos de configuración del modelo localmente. Si se establece en `True`, el modelo no se descargará desde el Hub. | |
| token (`str` o *bool*, *opcional*) : El token que se usará como autorización HTTP bearer para archivos remotos. Si es `True`, se utiliza el token generado por `diffusers-cli login` (almacenado en `~/.huggingface`). | |
| revision (`str`, *opcional*, valor predeterminado `"main"`) : La versión específica del modelo que se va a utilizar. Puede ser el nombre de una rama, el nombre de una etiqueta, un id de commit o cualquier identificador permitido por Git. | |
| original_config_file (`str`, *opcional*) : La ruta al archivo de configuración original que se utilizó para entrenar el modelo. Si no se proporciona, el archivo de configuración se inferirá a partir del archivo de checkpoint. | |
| config (`str`, *opcional*) : Puede ser: - Una cadena de caracteres, el *repo id* (por ejemplo `CompVis/ldm-text2im-large-256`) de un pipeline preentrenado alojado en el Hub. - Una ruta a un *directorio* (por ejemplo `./my_pipeline_directory/`) que contenga las configuraciones de los componentes del pipeline en formato Diffusers. | |
| disable_mmap ('bool', *opcional*, valor predeterminado 'False') : Si se debe deshabilitar mmap al cargar un modelo de Safetensors. Esta opción puede ofrecer un mejor rendimiento cuando el modelo está en una unidad de red o en un disco duro. | |
| kwargs (resto del diccionario de argumentos de palabra clave, *opcional*) : Se puede usar para sobrescribir las variables de carga y guardado (los componentes de pipeline de la clase de pipeline específica). Los componentes sobrescritos se pasan directamente al método `__init__` de los pipelines. Consulte el ejemplo siguiente para obtener más información. | |
| Instancia un [DiffusionPipeline](/docs/diffusers/v0.43.0/es/api/pipelines/overview#diffusers.DiffusionPipeline) a partir de pesos de pipeline preentrenados guardados en el formato `.ckpt` o `.safetensors`. El pipeline se establece en modo de evaluación (`model.eval()`) de forma predeterminada. | |
| Ejemplos: | |
| ```py | |
| >>> from diffusers import StableDiffusionPipeline | |
| >>> # Download pipeline from huggingface.co and cache. | |
| >>> pipeline = StableDiffusionPipeline.from_single_file( | |
| ... "https://huggingface.co/WarriorMama777/OrangeMixs/blob/main/Models/AbyssOrangeMix/AbyssOrangeMix.safetensors" | |
| ... ) | |
| >>> # Download pipeline from local file | |
| >>> # file is downloaded under ./v1-5-pruned-emaonly.ckpt | |
| >>> pipeline = StableDiffusionPipeline.from_single_file("./v1-5-pruned-emaonly.ckpt") | |
| >>> # Enable float16 and move to GPU | |
| >>> pipeline = StableDiffusionPipeline.from_single_file( | |
| ... "https://huggingface.co/stable-diffusion-v1-5/stable-diffusion-v1-5/blob/main/v1-5-pruned-emaonly.ckpt", | |
| ... torch_dtype=torch.float16, | |
| ... ) | |
| >>> pipeline.to("cuda") | |
| ``` | |
| ## FromOriginalModelMixin[[diffusers.loaders.FromOriginalModelMixin]] | |
| #### diffusers.loaders.FromOriginalModelMixin[[diffusers.loaders.FromOriginalModelMixin]] | |
| ```python | |
| diffusers.loaders.FromOriginalModelMixin() | |
| ``` | |
| [Fuente](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/loaders/single_file_model.py#L276) | |
| Cargue los pesos preentrenados guardados en el formato `.ckpt` o `.safetensors` en un modelo. | |
| #### from_single_file[[diffusers.loaders.FromOriginalModelMixin.from_single_file]] | |
| ```python | |
| from_single_file(pretrained_model_link_or_path_or_dict: str | None = None, **kwargs) | |
| ``` | |
| [Fuente](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/loaders/single_file_model.py#L281) | |
| **Parámetros:** | |
| pretrained_model_link_or_path_or_dict (`str`, *opcional*) : Puede ser: - Un enlace al archivo `.safetensors` o `.ckpt` (por ejemplo, `"https://huggingface.co/<repo_id>/blob/main/<path_to_file>.safetensors"`) en el Hub. - Una ruta a un *archivo* local que contiene los pesos del modelo de componente. - Un state dict que contiene los pesos del modelo de componente. | |
| config (`str`, *opcional*) : - Una cadena de caracteres, el *repo id* (por ejemplo `CompVis/ldm-text2im-large-256`) de un pipeline preentrenado alojado en el Hub. - Una ruta a un *directorio* (por ejemplo `./my_pipeline_directory/`) que contiene las configuraciones de los componentes del pipeline en formato Diffusers. | |
| subfolder (`str`, *opcional*, valor predeterminado `""`) : La ubicación de la subcarpeta de un archivo de modelo dentro de un repositorio de modelos más grande en el Hub o localmente. | |
| original_config (`str`, *opcional*) : Diccionario o ruta a un archivo yaml que contiene la configuración del modelo en su formato original. Si se proporciona un diccionario, se utilizará para inicializar la configuración del modelo. | |
| dtype (`torch.dtype`, *opcional*) : Anula el `torch.dtype` predeterminado y carga el modelo con otro dtype. | |
| force_download (`bool`, *opcional*, valor predeterminado `False`) : Indica si se debe forzar la (re)descarga de los pesos del modelo y los archivos de configuración, reemplazando las versiones en caché si existen. | |
| cache_dir (`str | os.PathLike`, *opcional*) : Ruta a un directorio donde se almacena en caché la configuración de un modelo preentrenado descargado si no se utiliza la caché estándar. | |
| proxies (`dict[str, str]`, *opcional*) : Un diccionario de servidores proxy a utilizar por protocolo o punto de acceso, por ejemplo, `{'http': 'foo.bar:3128', 'http://hostname': 'foo.bar:4012'}`. Los proxies se utilizan en cada solicitud. | |
| local_files_only (`bool`, *opcional*, valor predeterminado `False`) : Indica si se deben cargar únicamente los pesos y archivos de configuración del modelo localmente. Si se establece en True, el modelo no se descargará desde el Hub. | |
| token (`str` o *bool*, *opcional*) : El token que se usará como autorización HTTP bearer para archivos remotos. Si es `True`, se utiliza el token generado por `diffusers-cli login` (almacenado en `~/.huggingface`). | |
| revision (`str`, *opcional*, valor predeterminado `"main"`) : La versión específica del modelo que se va a utilizar. Puede ser el nombre de una rama, el nombre de una etiqueta, un id de commit o cualquier identificador permitido por Git. | |
| low_cpu_mem_usage (`bool`, *opcional*, por defecto `True` si la versión de torch >= 1.9.0 y : is_accelerate_available() en caso contrario `False`): Acelera la carga del modelo cargando solo los pesos preentrenados y no inicializando los pesos. Esto también intenta no usar más de 1x el tamaño del modelo en memoria de CPU (incluida la memoria pico) mientras se carga el modelo. Solo compatible con PyTorch >= 1.9.0. Si estás usando una versión anterior de PyTorch, establecer este argumento en `True` generará un error. | |
| disable_mmap ('bool', *opcional*, valor predeterminado 'False') : Si se debe deshabilitar mmap al cargar un modelo de Safetensors. Esta opción puede ofrecer un mejor rendimiento cuando el modelo está en una unidad de red o en un disco duro, que pueden no manejar bien la naturaleza de búsquedas aleatorias de mmap. | |
| kwargs (remaining dictionary of keyword arguments, *opcional*) : Se puede usar para sobrescribir las variables de carga y guardado (por ejemplo, los componentes de pipeline de la clase de pipeline específica). Los componentes sobrescritos se pasan directamente al método `__init__` de los pipelines. Consulte el ejemplo siguiente para obtener más información. | |
| Instancie un modelo a partir de pesos preentrenados guardados en el formato original `.ckpt` o `.safetensors`. El modelo se establece en modo de evaluación (`model.eval()`) de forma predeterminada. | |
| ```py | |
| >>> from diffusers import StableCascadeUNet | |
| >>> ckpt_path = "https://huggingface.co/stabilityai/stable-cascade/blob/main/stage_b_lite.safetensors" | |
| >>> model = StableCascadeUNet.from_single_file(ckpt_path) | |
| ``` | |
Xet Storage Details
- Size:
- 13.7 kB
- Xet hash:
- 086e6d3fe47d857e4e1d2552d7530c1185e49c8b457c58cf9e812ab8de6eb8fd
·
Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.