文章 · 2026-10-01

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 報錯的情況。

報錯時要查的是發出請求的那台機器：瀏覽器、伺服器或終端、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 實例所在的地區計算，而不是按用户本人所在的地區。也就是說，算數的是發出請求的那台機器在哪裏，不是人在哪裏。瀏覽器裏一切正常、程式卻報錯，常見的是這幾種情況：

程式跑在伺服器上：部署在雲伺服器上的程式調用 API，Google 看到的是伺服器的出口，和你自己的電腦無關。
終端沒用瀏覽器的代理：SDK、curl 和命令行工具跑在終端裏，瀏覽器的代理設定不會自動帶到終端，請求從終端自己的出口出去。
按域名分流：瀏覽器打開的是 aistudio.google.com，程式請求的是 generativelanguage.googleapis.com。代理規則按域名決定線路時，兩者可能走不同出口。原理見 ChatGPT、Claude 看到的是哪個 IP。
IPv6 走了另一條路：2026-10-01 查詢 DNS，generativelanguage.googleapis.com 和 aistudio.google.com 都有 IPv6 地址。代理只接管 IPv4 時，優先用 IPv6 的請求會從另一個出口出去，見 IPv6 泄露。
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 的程式在別處運行時，要到那台機器上查。判定依據見判定方法，各平台在兩地的情況見香港和中國大陸地區頁。