你打开受限模型的页面时，能看到介绍内容，却找不到可下载的文件——这一般不是浏览器出问题了，而是这个模型仓库开启了访问请求机制。申请人得先同意共享自己的 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 的预期状态里。
• 获批的账号能在网页端访问受限文件，命令行也用的是同一个账号的有效令牌。