Hugging Face Hub 受限模型访问申请与审批教程

当你打开某个受限模型的页面时，能看到详细的介绍，却找不到任何可下载的文件——别急着怀疑浏览器出了问题，其实，是这个模型仓库开启了访问请求机制。申请人需要先同意共享自己的Hugging Face用户名和邮箱；模型作者那边则要决定是直接自动放行，还是逐个手动审核。两条路径都是从网页界面开始操作的，而且授权的永远是个人账号，不会因为你的账号属于某个组织，就自动给整个组织都开通权限。

先搞清楚自己该走哪条路径

如果只是想下载或调用模型，那走“申请人”路径就好：登录个人账号、仔细阅读条件、提交申请，之后等着自动或人工审批就行。如果你是模型仓库的所有者，或者在组织仓库里有对应的写入权限，那就走“作者”路径：在模型设置里开启访问请求、选好审批方式，再处理申请名单。

需要特别说明的是，受限访问可不等于私有仓库。模型的介绍页可能还是公开的，但里面的文件和内容，得等你的账号拿到授权才能访问。申请之前，务必确认你登录的是打算长期使用的个人账号，而且邮箱能正常接收消息；申请授权是不会直接发给组织账号的。

模型作者怎么开启访问请求

第一步：找到Gated user access开关

进入你有管理权限的模型仓库，打开Settings页面，往下翻找到Gated user access这一块。初始状态会显示disabled，右上角的按钮是Enable Access requests。

确认仓库和账号都没问题之后，点击Enable Access requests就行。点完之后，后面再来访问模型文件的人，就得先提交联系信息，还要确认使用条件。

原来的disabled变成enabled，右上角的按钮变成Disable Access requests，同时还会出现New requests、Review access requests和下载访问报告之类的控件。如果在Settings里找不到这一块，先看看你打开的是不是模型仓库，再核对一下你的账号是不是仓库所有者，或者有没有组织仓库的管理权限；别在没权限的公开模型页面翻来覆去找按钮。

这张图里不用盯着说明文字看，重点看右上角的Enable Access requests按钮——它只会出现在模型的设置区域里，是整个开启流程的起点。

第二步：选择自动审批还是人工审核

访问请求开启之后，在New requests的右边点开下拉菜单。界面提供Automatic approval和Manual review两种方式。

如果是公开研究用的模型，只需要申请人确认条款的话，可以选Automatic approval；要是申请材料需要人工核对，或者模型有额外的使用条件，就选Manual review。自动审批的话，申请人提交信息之后马上就能拿到访问权限，待处理列表一般是空的；人工审核的话，新申请会被放到pending里。

下拉框里显示你刚选好的模式。切换之前先跟团队明确好审核责任和响应时间。不小心选了自动审批的话，申请会直接通过；误选人工审核的话，申请会一直停在pending状态，直到有人处理。

下拉菜单里的这两个选项，直接决定了申请要不要人工干预。旁边Review access requests后面的数字，能用来判断有没有待处理的申请记录。

第三步：配置人工审核和通知

把New requests改成Manual review之后，同一个区域会出现Add access、Notifications frequency和Notifications email这几个选项。

选好是实时通知还是每日汇总，再填上负责处理申请的邮箱。如果模型属于组织，默认通知可能会发给组织管理员；要是有固定的审核人，最好改成能长期维护的工作邮箱。如果已经知道用户名，不用对方先提交申请的话，可以用Add access主动给对方授权。

界面保持在Manual review模式，通知频率和通知邮箱都显示成你设置的预期值。如果一直收不到提醒，先回到这里检查邮箱拼写和通知频率，别只知道查垃圾邮件；多人协作的话还要明确谁负责看pending列表，免得大家都以为别人会处理。

从这张图里能看出来，人工审核可不只是一个模式开关：通知频率、通知邮箱还有主动授权的入口，都在同一块设置区域里。

申请人怎么提交受限模型访问请求

第四步：登录后读清条件再提交

登录你的Hugging Face个人账号，进入目标模型的页面。受限区域会提示你需要共享联系信息；有些模型还会要求填写公司、国家、用途、日期，或者勾选条款之类的附加字段。

先把模型许可和附加说明读明白，把必填项都填完整，再点击Agree and send request to access repo。点这个按钮就意味着你同意把当前账号的用户名和邮箱提供给模型作者；别用临时账号代替你真正要跑模型的账号。

如果是自动审批，提交之后你应该就能看到并下载之前受限的文件了；如果是人工审核，页面会显示申请已经发送，或者还在等待审批。如果按钮点不了，先检查你有没有登录、必填项和复选框是不是都填完勾完了。如果页面明确显示申请被拒绝了，申请人不能用同一个账号再发起申请，只能按照作者公开的沟通方式去说明情况；别靠重复注册账号来规避作者的决定。

提交之前一定要看清楚顶部的提示：这里授权的是联系信息共享和仓库访问，可不是给你这台电脑自动配置命令行令牌哦。

模型作者怎么处理申请名单

第五步：在pending列表里接受或拒绝申请

回到模型Settings里的Gated user access板块，点击Review access requests。弹出来的窗口分pending、accepted、rejected三个标签页。

在pending标签页里查看用户名、邮箱、提交时间和附加字段，再按照你们定好的标准选Accept或者Reject。点Accept会把这个账号移到accepted里，同时开放文件访问权限；点Reject会移到rejected里，而且会阻止这个账号再提交申请。如果已经接受的账号需要暂时撤回到待审状态，就用Cancel approval；只有要明确拒绝的时候才用Reject。

操作完之后对应标签的数量会变化，目标账号会出现在你预期的列表里。如果列表是空的，先确认当前模型是不是设成了Manual review；自动审批模式下，新申请一般会直接进到accepted里。如果点按钮时报了权限错误，就检查下当前账号和访问令牌对这个仓库有没有写权限。

审核的时候先看清楚标签页，再点操作按钮。pending是还没处理的；accepted是已经有访问权的；rejected是已经被明确拒绝的，这三个状态的后续影响不一样。

第六步：用访问报告或者Python客户端批量核对

设置区里的Download user access report可以导出全部访问记录；如果需要自动化处理，就用已经登录、而且对仓库有写权限的本地环境来调用huggingface_hub。

报告里重点核对user、fullname、status、email、time和reviewedAt这几项。用程序处理之前，先只读取pending列表，确认用户名没错，再执行接受、取消或者拒绝的操作。令牌要存在Hugging Face的登录配置或者安全环境里，别直接写在脚本正文里。

from huggingface_hub import list_pending_access_requests

repo_id = "namespace/model-name"
requests = list(list_pending_access_requests(repo_id))

for item in requests:
    print(item.user, item.email, item.time)

读取结果能返回到待审账号，接受之后再查列表，目标账号就不在pending里了，而是出现在accepted里。如果出现401错误，先检查你这台电脑有没有登录；出现403错误的话，检查令牌对目标仓库有没有写权限；列表是空的就核对下仓库ID、仓库类型和审批模式。千万别在没确认用户名的情况下批量接受申请。

获批之后怎么验证网页和命令行的访问权限

网页端保持同一个账号登录，重新打开模型文件列表，试着打开一个之前受限的文件。如果文件内容能正常显示或者开始下载，说明网页端的授权已经生效了。命令行端先运行hf auth login保存同一个账号的用户令牌，再用对应的库或者下载命令访问模型；如果网页端已经获批了，但脚本还是提示没权限访问，最常见的原因就是你这台电脑登了另一个账号、令牌没读到，或者作者后来取消了你的访问权。

这里需要提醒一下：作者是可以随时取消或者拒绝已经授予的访问权限的，申请人可别觉得一次通过就是永久授权了。模型条款、附加字段和地区限制也可能会变，实际使用之前，还是以模型页当前显示的条件为准。

最后给你列个完成检查清单

• 申请人确认自己用的是正确的个人账号，并且清楚会向模型作者共享用户名和邮箱。
• 作者已经在模型Settings里看到enabled状态，而不是只打开了公开模型的页面。
• 选的Automatic approval或者Manual review，和团队实际的审核流程是一致的。
• 人工审核的通知邮箱、通知频率和负责人都已经确认好了。
• 接受、取消、拒绝操作之后，账号分别落到accepted、pending、rejected的预期状态里。
• 获批的账号能在网页端访问受限文件，命令行也用的是同一个账号的有效令牌。