怎么注册HuggingFace的api token
时间: 2025-04-24 09:13:19 浏览: 80
### 如何注册 HuggingFace API Token
对于希望访问特定资源如私有模型或数据集、上传内容至 Hugging Face Hub 或者处理带有使用限制的项目,用户需先验证身份。这涉及到创建并应用一个API访问令牌。
#### 创建具有写权限的访问令牌
前往[Hugging Face设置页面](https://huggingface.co/settings/tokens),在此处可以生成新的访问令牌[^1]。确保所选权限级别满足需求;通常情况下,“write”级别的权限就足够用于大多数操作了。
#### 登录方法概述
存在多种方式可用于利用此令牌完成登录:
- **Jupyter Notebook**: 使用`from huggingface_hub import notebook_login`语句导入必要的函数,并调用它以启动交互式的认证流程,在提示下输入个人令牌即可。
```python
from huggingface_hub import notebook_login
notebook_login()
```
- **Python脚本内部**: 对于非交互式环境中执行的任务,则可以直接通过编程的方式提供令牌字符串给`login()`函数作为参数来实现自动化登录过程。
```python
from huggingface_hub import login
login(token="your_token")
```
- **命令行工具**: 安装官方CLI客户端之后,可以通过简单的命令行指令来进行登录动作,同样是在被询问时提交之前准备好的令牌值。
```
pip install huggingface_hub
huggingface-cli login
```
另外一种持久化保存令牌的方法是将其设为环境变量的一部分,这样可以在不改变现有代码的前提下享受自动化的便利性。
```bash
export HUGGINGFACE_TOKEN=your_token
```
最后,为了确认一切正常工作,可尝试运行`huggingface-cli whoami`查看当前已授权的信息。
#### 特定资源访问请求
针对某些特殊的数据集比如提到的例子,除了上述常规步骤外还需要额外向指定位置发起访问权申请才能正常使用这些资料[^3]。
阅读全文
相关推荐


















