torch.utils.model_zoo

创建日期：2017 年 1 月 9 日 | 最后更新：2025 年 6 月 11 日

已移动至 torch.hub。

torch.utils.model_zoo.load_url(url, model_dir=None, map_location=None, progress=True, check_hash=False, file_name=None, weights_only=False)

加载给定 URL 处的 Torch 序列化对象。

如果下载的文件是 zip 文件，它将自动解压。

如果对象已存在于 model_dir 中，则直接反序列化并返回。 model_dir 的默认值为 <hub_dir>/checkpoints，其中 hub_dir 是由 get_dir() 返回的目录。

参数:

• url (str) – 要下载的对象的 URL

• model_dir (str, optional) – 保存对象的目录

• map_location (optional) – 指定如何重映射存储位置的函数或字典（参见 torch.load）

• progress (bool, optional) – 是否在 stderr 中显示进度条。默认值：True

• check_hash (bool, optional) – 如果为 True，则 URL 的文件名部分应遵循命名约定 filename-<sha256>.ext，其中 <sha256> 是文件内容 SHA256 哈希值的前八位或更多位数字。哈希值用于确保名称唯一并验证文件内容。默认值：False

• file_name (str, optional) – 下载文件的名称。如果未设置，将使用 url 中的文件名。

• weights_only (bool, optional) – 如果为 True，则仅加载权重，不加载复杂的 pickled 对象。建议用于不受信任的来源。详情请参阅 load()。

返回类型:

dict[str, Any]

示例

>>> state_dict = torch.hub.load_state_dict_from_url(
...     "https://s3.amazonaws.com/pytorch/models/resnet18-5c106cde.pth"
... )