用户访问令牌

什么是用户访问令牌？

用户访问令牌是应用程序或 Jupyter Notebook 认证 Hugging Face 服务的首选方式。您可以在您的设置中管理您的访问令牌。

访问令牌允许应用程序和 Jupyter Notebook 执行由以下角色范围指定的特定操作：

• fine-grained（细粒度）：具有此角色的令牌可用于提供对特定资源的细粒度访问，例如特定模型或特定组织中的模型。这种类型的令牌在生产环境中非常有用，因为您可以使用自己的令牌，而无需共享对所有资源的访问权限。

• read（读取）：具有此角色的令牌只能用于提供对您可读取的仓库的读取访问权限。这包括您或您所属组织拥有的公共和私有仓库。如果您只需要从 Hugging Face Hub 读取内容（例如，下载私有模型或执行推理），请使用此角色。

• write（写入）：具有此角色的令牌还授予对您拥有写入权限的仓库的写入访问权限。如果您需要创建内容或将内容推送到仓库（例如，训练模型或修改模型卡），请使用此令牌。

请注意，组织 API 令牌已被弃用

如果您是具有读/写/管理员角色的组织的成员，那么您的用户访问令牌将能够根据令牌权限（读/写）和组织成员身份（读/写/管理员）读取/写入资源。

如何管理用户访问令牌？

要创建访问令牌，请前往您的设置，然后点击访问令牌选项卡。点击新建令牌按钮创建一个新的用户访问令牌。

选择令牌的角色和名称，就是这样——您就可以开始了！

您可以通过点击管理按钮删除和刷新用户访问令牌。

如何使用用户访问令牌？

有多种方法可以使用用户访问令牌访问 Hugging Face Hub，为您提供了在其上构建出色应用程序所需的灵活性。

用户访问令牌可以：

• 用作密码的替代品，通过 git 或基本认证访问 Hugging Face Hub。
• 在调用推理提供商时作为承载令牌传递。
• 在 Hugging Face Python 库中使用，例如 transformers 或 datasets。

from transformers import AutoModel

access_token = "hf_..."

model = AutoModel.from_pretrained("private/model", token=access_token)

最佳实践

我们建议您为每个应用程序或用途创建一个访问令牌。例如，您可以为以下各项设置单独的令牌：

• 一台本地机器。

• 一个 Colab 笔记本。

• 一个出色的自定义推理服务器。

  这样，您就可以在不影响其他用途的情况下使某个令牌失效。

我们还建议仅在生产环境中使用细粒度令牌。如果泄露，影响会降低，并且它们可以在您的组织内共享，而不会影响您的帐户。

例如，如果您的生产应用程序需要对受限模型的读取访问权限，则您的组织成员可以请求访问该模型，然后创建一个对该模型具有读取访问权限的细粒度令牌。此令牌随后可以在您的生产应用程序中使用，而无需授予其对所有私有模型的访问权限。