从 Hugging Face Hub 获取 Xet 文件 ID

本节说明在重建 API 中用于使用 xet 协议从 Hugging Face Hub 下载文件的 Xet 文件 ID。

给定特定的命名空间、仓库和分支或提交哈希以及从仓库根目录的文件路径，按照以下格式构建文件的"resolve" URL：

定义：
namespace: 用户名/组织，例如 Qwen
repository: 仓库名称，例如 Qwen-Image-Edit
branch: 任何 git 分支或提交哈希，例如 main
filepath: 仓库中的文件路径，例如 transformer/diffusion_pytorch_model-00001-of-00009.safetensors 

resolve URL:

https://huggingface.co/{namespace}/{repository}/resolve/{branch}/{filepath}


示例:

https://huggingface.co/Qwen/Qwen-Image-Edit/resolve/main/transformer/diffusion_pytorch_model-00001-of-00009.safetensors

然后使用你的标准 Hugging Face Hub 凭据/令牌向 resolve URL 发出 GET 请求。

如果文件存储在 xet 系统上，则成功响应将具有 X-Xet-Hash 标头。

此标头的字符串值是 Xet 文件 ID，应在重建 API URL 的路径中使用。 这是哈希的字符串表示，可以直接在下载时的文件重建 API 中使用。

备注

resolve URL 将返回 302 重定向 http 状态代码，遵循重定向将通过旧的 LFS 兼容路由而不是通过 Xet 协议下载内容。 为了使用 Xet 协议，你不得遵循此重定向。