用户访问令牌

什么是用户访问令牌？

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

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

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

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

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

请注意，组织 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 笔记本。

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

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

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

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