Hugging Face 访问令牌申请指南:以 Meta-Llama-3.1-8B-Instruct 为例
申请模型访问权限
大多数开源大模型在 Hugging Face 上属于受限资源,直接访问会被拦截。首先需要进入目标模型页面,例如 Meta-Llama-3.1-8B-Instruct。
点击页面上的访问申请链接,系统会引导填写相关信息。填写时请注意以下两点:
- 国家建议选择'美国',机构类型选择'大学'。
- 确保当前网络环境与该地区一致,避免因 IP 不符导致审核延迟。
提交后通常会有几分钟的审核期,请耐心等待。
![图片:模型页面授权成功提示]
确认访问权限状态
提交申请后,可以通过两种方式确认是否通过:
- 页面提示:再次访问模型仓库,若看到'Gated model You have been granted access to this model'字样,即表示授权成功。
- 个人中心:点击右上角头像,进入 Settings > Gated Repositories。查看申请的模型列表,当 Request Status 从 PENDING 变为 ACCEPTED 时,即可正常访问。
![图片:个人中心审核状态截图]
生成访问令牌
拥有模型访问权后,还需获取 API Token 才能在代码中调用。
- 点击头像进入 Settings。
- 选择 Access Tokens 选项卡。
- 点击 Generate New Token,根据需求选择权限范围(Read/Write)。
- 复制生成的令牌并妥善保存,后续在代码中通过环境变量或配置文件注入使用。
![图片:Token 生成界面]
注意事项
- 令牌具有敏感性,切勿泄露给他人或上传至公开代码库。
- 部分模型审核可能需要更长时间,如遇问题可尝试刷新页面或联系支持。
- 确保本地开发环境已安装必要的依赖库(如 transformers),并正确配置了代理网络。


