使用者訪問令牌

什麼是使用者訪問令牌？

使用者訪問令牌是應用程式或 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 筆記本。

• 一個出色的自定義推理伺服器。

  這樣，您就可以在不影響其他用途的情況下使某個令牌失效。

我們還建議僅在生產環境中使用細粒度令牌。如果洩露，影響會降低，並且它們可以在您的組織內共享，而不會影響您的帳戶。

例如，如果您的生產應用程式需要對受限模型的讀取訪問許可權，則您的組織成員可以請求訪問該模型，然後建立一個對該模型具有讀取訪問許可權的細粒度令牌。此令牌隨後可以在您的生產應用程式中使用，而無需授予其對所有私有模型的訪問許可權。