服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 新建网关省略 authentication 或设为 true 均可；设为 false 会返回 HTTP 400。
- 更新时省略该字段会保留现状；认证一旦开启便不能关闭。
- Cloudflare REST API 使用 Authorization；gateway.ai.cloudflare.com 原生入口使用 cf-aig-authorization。
- AI Gateway Read、Run、Edit 权限按账号生效，Run 可访问该账号下所有网关，包括配置了 BYOK 密钥的网关。
先判断网关是新建还是已有
Cloudflare 于 2026 年 11 月 3 日发布变更：新建 AI Gateway 现在必须启用认证。创建时可以省略 authentication 字段，也可以明确设为 true；发送 authentication: false 会得到 HTTP 400。认证开启后，不能再通过控制台或 API 关闭。
已有网关若从未启用认证，可以继续保持未认证状态；也可以选择开启。开启后就不能关回去。控制台设置和 API 更新遵循同一条不可逆边界，因此在已有网关上启用前，应先核对会访问它的客户端。
按更新请求判断 HTTP 400
更新现有网关时，省略 authentication 会保留当前设置。显式设为 true 会开启认证，并使它保持开启；如果网关已经认证，随后尝试设为 false 会返回 HTTP 400，响应说明认证启用后不能禁用。
只有仍处于未认证状态的旧网关可以在更新请求中带 authentication: false。这个例外只是保留旧网关原有状态，并不允许先开启再关闭。排查 400 时，先确认目标网关当前是否已启用认证，再检查请求中是否误带 false。
按请求入口选择认证头
调用 Cloudflare REST API（api.cloudflare.com）时，在标准 Authorization 请求头中传入 Cloudflare API token。调用 gateway.ai.cloudflare.com 上的 provider-native 入口时，使用 cf-aig-authorization。两种入口仍受支持；Cloudflare 对新集成推荐使用 REST API。
通过 Cloudflare Worker 的 AI Gateway binding 发起的请求，在关联的 Cloudflare 账号内已预先认证，不需要手动附加 cf-aig-authorization。不要把这一点外推到普通 HTTP 客户端：直接请求仍须遵循对应入口的认证方式。
把令牌权限范围算进网关隔离
AI Gateway Read、Run 和 Edit 权限按账号范围授予，不能限制到单个网关。拥有 Run 权限的令牌可以向该账号中的每个网关发送请求，包括配置了 Bring Your Own Keys（BYOK）存储提供商密钥的网关；这类调用可能消耗对应的提供商凭据。
因此，检查认证时也要确认令牌属于哪个账号、获授哪些 AI Gateway 权限，以及持有 Run 权限的调用者实际能访问哪些网关。Cloudflare 文档将不同账号或 Worker 侧 AI Gateway binding 列为网关或租户隔离的选项。不要把一个 AI Gateway 的认证头误当成单网关授权。
区分网关认证与上游提供商凭据
这里的 Cloudflare API token 或 cf-aig-authorization 负责满足 AI Gateway 入口的认证要求；它不会替代网关转发上游模型请求时所需的提供商配置。若网关使用 BYOK，请继续按提供商要求维护对应凭据，并分别核对入口访问权限与上游配置。 若实际目标是受 Zero Trust Access 保护的应用，另看 Access 服务令牌排查指南，先确认自己正在配置哪一种产品入口。
截至 2026 年 11 月 4 日，本文依据 Cloudflare 的 11 月 3 日变更记录及当前认证文档整理。这两项来源没有给出精确到时分的启用时间，也没有提供统一的地区、套餐或费用清单；具体服务条件仍需按当前产品与提供商说明核对，不能把配置规则当成某个账号已调用成功的证据。
资料来源
常见问题
Cloudflare Access 的服务令牌能直接替代这里的认证吗？
这次 AI Gateway 文档要求的是 Cloudflare API token，不应把 Access 的 CF-Access-Client-Id 与 CF-Access-Client-Secret 当作 AI Gateway 认证头。Zero Trust Access 保护的应用使用另一套服务令牌与策略规则。
开启认证是否意味着模型调用免费？
不能这样推导。认证控制谁能通过网关发起请求；这两项来源没有宣布模型或提供商调用免单。特别是 Run 令牌可使用账号内配置的 BYOK 凭据，应另行核对对应产品和提供商的现行费用。