用户访问令牌

什么是用户访问令牌？

用户访问令牌是将应用程序或笔记本电脑验证到 Hugging Face 服务的首选方式。您可以在您的设置中管理您的访问令牌。

访问令牌允许应用程序和笔记本电脑执行以下角色范围指定的特定操作

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

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

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

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

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

如何管理用户访问令牌？

要创建访问令牌，请转到您的设置，然后单击“访问令牌”选项卡。单击“新令牌”按钮以创建新的用户访问令牌。

为您的令牌选择角色和名称，瞧！您已准备就绪！

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

如何使用用户访问令牌？

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

用户访问令牌可以

• 用作密码来通过 git 或基本身份验证访问 Hugging Face Hub。
• 在调用推理 API 时作为承载令牌传递。
• 在 Hugging Face Python 库中使用，例如 transformers 或 datasets

from transformers import AutoModel

access_token = "hf_..."

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

最佳实践

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

• 本地机器。

• Colab 笔记本。

• 一个很棒的自定义推理服务器。

  这样，您可以使一个令牌失效，而不会影响您的其他用途。

我们还建议仅将细粒度令牌用于生产用途。如果泄露，影响将减少，并且可以在您的组织内共享，而不会影响您的帐户。

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