当你访问Hugging Face上某个受限模型的页面时，虽然能看到详细的模型介绍，却无法直接找到任何可下载的文件——这并非浏览器出现了异常，而是该模型仓库已启用访问请求机制。申请人需要先同意共享自己的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的预期状态。
- 获批的账号能在网页端访问受限文件，命令行也使用同一账号的有效令牌。
