首次使用 Youtube API 遇到 Error 402，如何解除 IP 封禁？

2026-10-24支付老李

结论

这类 HTTP 402: Payment Required 通常不表示需要付费，也不代表当前程序的调用次数已经超限。在 youtube-dl 的使用场景中，它更可能是 YouTube 对服务器出口 IP 采取了风控措施。

即使程序是第一次运行，服务器 IP 也可能被之前的租户使用过，或者所在数据中心的整个 IP 段信誉不佳。客户端无法通过某个 API 参数自行解除限制。可行的处理方式通常是等待风控解除、更换信誉较好的出口 IP，或者让浏览器通过该服务器的 IP 完成人机验证。

如果使用的是官方 YouTube Data API，而不是 youtube-dl、yt-dlp 或直接访问 YouTube 网页，则需要重新核对请求地址。官方 API 的配额和权限问题通常返回 403，而不是这里讨论的 402。

YouTube 判断访问风险时，会综合考虑公网出口 IP、IP 段、请求模式和会话状态，并非只看当前服务器上的调用记录。常见原因包括：

所以，程序第一次运行，不等于这个 IP 第一次访问 YouTube。

如果请求地址类似：

https://www.googleapis.com/youtube/v3/...

使用的就是 YouTube Data API。此时应该检查 API Key、OAuth 凭据、项目配额，以及错误响应中的 reason 字段，不要直接套用 youtube-dl 的 402/429 处理方式。

如果运行的是：

youtube-dl VIDEO_URL

或者：

yt-dlp VIDEO_URL

这些工具主要访问 YouTube 网站及媒体接口，并不等同于调用官方 YouTube Data API。此时出现的 402 更可能来自网站侧的 IP 风控。

先停止自动重试。持续、快速地重试可能会延长受限时间。

恢复测试时，先只运行一个请求，不要启用并发下载：

yt-dlp --verbose "https://www.youtube.com/watch?v=VIDEO_ID"

--verbose 输出可能包含路径、代理地址或其他环境信息。对外发布日志前，需要先检查并脱敏。

如果单次请求成功，再逐步增加任务量，并在任务之间设置合理间隔。不要让失败请求进入没有延迟的无限重试循环。

先确认程序实际使用的出口 IP：

curl https://api.ipify.org

如果服务器配置了代理、VPN、IPv6 或多个出口，命令行工具与浏览器看到的公网 IP 可能不同。进行人机验证时，应尽量使用与实际请求相同的出口 IP。

也可以分别测试 IPv4 和 IPv6：

curl -4 https://api.ipify.org
curl -6 https://api64.ipify.org

如果某个协议对应的地址受到限制，工具可能因为网络选择不同而出现不一致的结果。但不要依靠反复切换地址来规避平台限制。

dedicated server 没有桌面环境，也可以完成浏览器验证。你可以在本地电脑上建立 SSH SOCKS 代理，让浏览器流量通过服务器转发：

ssh -D 1080 -N user@server.example.com

然后将本地浏览器的代理设置为：

SOCKS5
Host: 127.0.0.1
Port: 1080

建议启用”通过 SOCKS 代理解析 DNS”之类的选项，避免部分请求绕过代理。设置完成后，先确认浏览器显示的公网 IP 与服务器一致，再访问 YouTube，并按照页面提示完成验证。

验证完成后，可以将该浏览器会话的 Cookie 导出到服务器，供下载工具使用：

yt-dlp --cookies /path/to/cookies.txt \
  "https://www.youtube.com/watch?v=VIDEO_ID"

对于 youtube-dl：

youtube-dl --cookies /path/to/cookies.txt \
  "https://www.youtube.com/watch?v=VIDEO_ID"

Cookie 文件包含登录凭据，需要设置严格的访问权限：

chmod 600 /path/to/cookies.txt

这种方法不能保证解除限制。YouTube 可能同时检查 IP、Cookie、账号和其他会话信息，而且验证结果可能只在有限时间内有效。

如果浏览器通过同一 IP 访问时仍然反复出现验证或被拒绝，可以联系服务器提供商：

同一数据中心的相邻 IP 可能具有相似的信誉，因此只换成同一网段内的另一个地址未必有效。

临时风控有时会在停止请求一段时间后自行解除，但持续时间没有可靠保证。不要假定等待固定的几分钟或几小时就一定能够恢复，也不要用脚本持续探测。

可以每隔较长时间进行一次单请求测试。如果长期没有恢复，更换出口 IP 通常比不断重试更实际。

如果已有合法、可信且稳定的 HTTP 代理，可以进行显式配置：

yt-dlp --proxy "http://proxy.example.com:8080" \
  "https://www.youtube.com/watch?v=VIDEO_ID"

SOCKS5 代理示例：

yt-dlp --proxy "socks5://127.0.0.1:1080" \
  "https://www.youtube.com/watch?v=VIDEO_ID"

代理需要能够完整转发 HTTPS 请求。免费代理、共享代理和公开 VPN 的 IP 信誉通常更差，还可能窃取 Cookie 或登录信息，不适合处理账号会话。