IP 判官 ipjudge.org

文章 ·

User location is not supported for the API use 是什么意思？Gemini API 和 AI Studio 提示地区不可用的原因与查法

先说结论：Gemini API 返回 User location is not supported for the API use.（状态 FAILED_PRECONDITION，HTTP 400），或者打开 Google AI Studio 提示所在地区不可用，意思是 Google 认为这次请求来自它的 API 名单以外的地区；要查的是发出请求的那台机器的出口，不是你在浏览器里看到的出口。截至 2026-10-01，Gemini API 和 AI Studio 共用一份名单，共 229 个国家和地区，中国大陆、香港、澳门都不在其中。香港、澳门在 Gemini 网页版的名单里，所以在这两地可能出现网页版能用、API 报错的情况。

一图看懂：Google 看哪台机器的出口浏览器打开 AI Studio，看的是浏览器这条路的出口；服务器或终端里的程序调用 Gemini API，看的是那台机器的出口，浏览器的代理不会自动带过去；在 Colab 里调用，按 Colab 实例所在地区判断，不按你本人所在地区。 一图看懂：Google 看哪台机器的出口 浏览器：AI Studio 网页 可能分流 浏览器 分流规则 浏览器出口 打开 aistudio.google.com 时， 看的是浏览器这条路的出口。 服务器 / 终端：调 API 各用各的 程序 这台机器 机器的出口 SDK、curl、命令行工具不会自动用 浏览器的代理，看的是这台机器的出口。 Colab：在笔记本里调 API 看实例地区 笔记本 Colab 实例 实例的出口 按 Colab 实例所在地区判断， 不按你本人所在地区。 在发出请求的那台机器上运行 curl ipjudge.org 查出口
报错时要查的是发出请求的那台机器：浏览器、服务器或终端、Colab 实例，各有各的出口。

本文依据 Google AI for Developers 的 API 可用地区页（最后更新 2026-04-28）、故障排除页、API 错误码页、AI Studio 故障排除页、Gemini API 附加服务条款，Gemini 帮助中心的网页版可用地区页，以及 Google Cloud 的相关文档，均于 2026-10-01 查阅。社区报告单独注明。

这条错误长什么样、出现在哪里

  • 直接调用 API：用户在 Google AI 开发者论坛贴出的返回内容是 {"error":{"code":400,"message":"User location is not supported for the API use.","status":"FAILED_PRECONDITION"}}（社区帖子）。用 SDK 时，这段内容通常包在 SDK 自己的异常信息里。
  • 命令行工具：有用户在 Google 的 Gemini CLI 仓库里报告，使用时看到 API Error: User location is not supported for the API use. (Status: FAILED_PRECONDITION)（社区报告）。
  • Google AI Studio：API 可用地区页写明，访问 AI Studio 时被带到这一页，可能有三种原因：所在地区不可用（Google AI Studio is not available in your region.）、未满 18 周岁、Google 账号还没有完成年龄验证。AI Studio 故障排除页还写到，看到 403 Access Restricted 表示使用方式不符合服务条款，常见原因之一就是不在支持的地区；不在支持地区时，界面或 API 返回里也可能出现 PERMISSION_DENIED 或访问受限的错误。

Google 目前的文档没有逐字收录 User location is not supported 这句提示。故障排除页（2026-09-20 更新）已把错误码表移到 API 错误码页，那里把 failed_precondition 列为 400，解释是「前提条件不满足（例如未开通计费）」，没有专门提到地区。

另一条同为 400 FAILED_PRECONDITION 的提示要分开看：故障排除页 2026-06-10 版本（存档）的错误码表里，对应的是 Gemini API free tier is not available in your country. Please enable billing on your project in Google AI Studio.，意思是所在地区不能用免费层，官方给的处理办法是在 AI Studio 里为项目开通计费。它和 User location 那条不是同一个提示。

API 名单和网页版名单是两份

Google 给 Gemini 网页版、手机 App 和 Gemini API / AI Studio 分别公布名单。截至 2026-10-01：

  • API 和 AI Studio 名单：229 个国家和地区，没有中国大陆、香港、澳门，台湾在列。
  • 网页版名单：有香港、澳门；中国大陆一项标注「仅限 Workspace」（Mainland China (Workspace only)）。

附加服务条款（2026-03-23 生效）写明：只能在可用地区内访问这些服务，也只能在可用地区内向用户提供 API 客户端；使用者须年满 18 周岁；AI Studio 和 Gemini API 面向以专业或商业用途开发产品的开发者。也就是说，用 Gemini API 做出来的产品，提供给哪些地区的用户，同样受这份名单约束。三份名单的对照和各地情况见 Gemini 国内和香港能用吗。

为什么浏览器正常，服务器或终端却报错

Google 没有公开 API 判断位置的具体方法。可用地区页给 Colab 用户的说明是：地区限制按 Colab 实例所在的地区计算，而不是按用户本人所在的地区。也就是说，算数的是发出请求的那台机器在哪里，不是人在哪里。浏览器里一切正常、程序却报错，常见的是这几种情况：

  1. 程序跑在服务器上：部署在云服务器上的程序调用 API，Google 看到的是服务器的出口，和你自己的电脑无关。
  2. 终端没用浏览器的代理：SDK、curl 和命令行工具跑在终端里，浏览器的代理设置不会自动带到终端，请求从终端自己的出口出去。
  3. 按域名分流：浏览器打开的是 aistudio.google.com，程序请求的是 generativelanguage.googleapis.com。代理规则按域名决定线路时，两者可能走不同出口。原理见 ChatGPT、Claude 看到的是哪个 IP。
  4. IPv6 走了另一条路：2026-10-01 查询 DNS，generativelanguage.googleapis.com 和 aistudio.google.com 都有 IPv6 地址。代理只接管 IPv4 时，优先用 IPv6 的请求会从另一个出口出去，见 IPv6 泄露。
  5. IP 定位本身有偏差：Google AI 开发者论坛里，有用户的服务器放在德国、新加坡的机房，这些国家都在名单里，仍收到这个错误；后一帖里有人新建服务、改用别的部署区域后恢复，也有人几天后自行恢复，Google 没有说明原因（社区帖子）。

在 Colab 里报错

按 API 可用地区页的说明，在 Colab 笔记本里调用 Gemini API，地区按 Colab 实例所在地判断，你本人在名单内的地区也不影响结果。Google 建议在笔记本里运行 !curl ipinfo.io 查看实例的位置；也可以运行 !curl ipjudge.org，输出里的「Gemini API」一行会直接说明实例出口的地区在不在 API 名单里。

不在名单里的地区，Google 文档指向哪里

API 可用地区页写的是：不在这些国家和地区的，可以试试 Gemini Enterprise Agent Platform 里的 Gemini API。按 Google Cloud 的改名说明，Gemini Enterprise Agent Platform 原名 Vertex AI Platform。

Google 的对比页（2026-09-30 更新）写明了几点差别：要改用 Google Cloud 服务账号认证；两者支持的区域可能不同；Interactions API 在该平台的预览期只支持 global 端点。这里的「区域」指模型部署的数据中心端点（例如 us-central1、global），和 ai.google.dev 那份按国家和地区列出的名单不是一回事。Google 的这几页都没有写明在中国大陆、香港、澳门能否使用，本文没有核实。

怎么查调用 API 那台机器的出口

服务器或终端：在发出请求的那台机器、那个终端里运行：

curl ipjudge.org
curl -6 ipjudge.org

第一条输出这台机器的出口 IP、是住宅还是机房、所在地区和网络，以及各平台各一行。其中「Gemini API」一行按出口地区对照 API 名单：在名单里时显示「地区在 Google 公布的 Gemini API / AI Studio 可用名单里（这份名单和网页版分开）」，出口在香港时则显示「香港不在 Google 公布的 Gemini API / AI Studio 可用名单里（网页版另有名单）」。第二条只在机器有 IPv6 时有结果，用来确认 IPv6 出口是否在同一地区。

浏览器：打开 Gemini 地区检测。Gemini 卡片的主结论按网页版名单判断，下面另起一行「API / AI Studio」，按打开本站时的出口地区对照 API 名单（本站 2026-10-01 核对），显示「地区在名单内」或「地区不在名单内」。这一行只看地区，不看出口是住宅还是机房，因为在服务器上调用 API 本来就很常见；出口地区查不出来时，不显示这一行。

有两点要留意。第一，本站按自己使用的 IP 数据判断地区，Google 的定位不一定一致；Google 也没有公开它看到的 IP，本站读不出 Google 一侧的判断。第二，浏览器里查到的只是浏览器这条路的出口，调用 API 的程序在别处运行时，要到那台机器上查。判定依据见 判定方法，各平台在两地的情况见 香港 和 中国大陆 地区页。

报错后按这三步查第一步，找到发出请求的机器：浏览器、服务器、终端还是 Colab 实例。第二步，在那台机器上运行 curl ipjudge.org，看「Gemini API」一行。第三步，对照 API 名单而不是网页版名单：不在名单内，Google 文档指向 Gemini Enterprise Agent Platform；在名单内仍报错，查 IPv6 出口，IP 定位也可能有偏差（社区报告）。 报错后按这三步查 1 找到发出请求的机器 浏览器、服务器、终端，还是 Colab 实例 2 在那台机器上查出口 curl ipjudge.org 看输出里「Gemini API」那一行； 浏览器看 /gemini/ 页的 API 一行 3 对照 API 名单，不是网页版名单 不在名单 Google 文档指向 Gemini Enterprise Agent Platform 在名单仍报错 先查 IPv6 出口；IP 定位 也可能有偏差（社区报告） 名单依据 Google API 可用地区页（更新于 2026-04-28）
先确定是哪台机器发出的请求，再在那台机器上查出口；对照的是 API 名单，不是网页版名单。

常见问题

人在香港，网页版 Gemini 能用，API 为什么报这个错？

两者用的是两份名单。截至 2026-10-01，香港、澳门在网页版名单里，不在 API 和 AI Studio 名单里。

出口确认在名单内的地区，仍然报 User location is not supported？

先在报错的那台机器上分别确认 IPv4、IPv6 出口都在名单内的地区。论坛里有机房 IP 被定位错的报告，有用户提到通过 Google 搜索帮助的 Report IP problems 表单反馈过 IP 位置（社区报告，Google 没有说明这个表单是否适用于 Gemini API）。

提示 free tier is not available in your country，和这个是一回事吗？

不是。按故障排除页 2026-06 的版本，那条提示说的是所在地区不能用免费层，官方给的处理办法是为项目开通计费；User location 那条说的是请求来自名单以外的地区。

IP 判官显示「地区在名单内」，能保证 API 不报错吗？

不能。Google 没有公开判断细则，本站能做的是读出那台机器的出口，并对照 Google 公布的名单。

想知道你自己的 IP 属于哪一类？

免费检测我的 IP