如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

在 Google Cloud 上使用 OpenAI 模型

透過 Google Cloud 存取 OpenAI 模型的功能目前處於私人預覽階段。如要在專案中使用這些模型,請申請存取權。

你可以透過 Google Cloud 在 Gemini 平台上使用 OpenAI 模型,使用費用會計入你的 Google Cloud 帳戶。這些模型在 Google Cloud 的安全邊界內執行,你的機構可透過 Google Cloud IAM 管理存取權。

本指南說明如何透過 Google Cloud 傳送 Responses API 請求,並比較 Google Cloud 與 OpenAI 第一方 API 在功能支援上的差異。

目前可使用下列模型:

模型 模型 ID
GPT-6 Luna gpt-6-luna
GPT-6.1 Sol gpt-6.1-sol
GPT-6.1 Terra gpt-6.1-terra
GPT-6 Astra gpt-6-astra

開始之前

在你傳送請求前,Google Cloud 管理員必須先完成下列事項:

  • 為專案啟用計費、安排專案審批,並與帳單管理員協調接受市集私人報價的事宜。
  • 啟用 Vertex AI API(aiplatform.googleapis.com),並在 Model Garden 中啟用模型及接受模型條款。
  • 如果機構政策限制模型存取權,請在該政策中允許存取此模型。
  • 授予傳送請求的使用者或服務帳戶呼叫模型的權限,例如指派 roles/aiplatform.user 角色。

專案準備就緒後,請向管理員索取專案 ID。

首次呼叫 API

在本機開發時,請先安裝 Google Cloud CLI,再使用具備專案存取權的 Google 帳戶登入:

gcloud auth application-default login

在稍後要用來傳送請求的終端中取得存取權杖:

export GOOGLE_CLOUD_ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"

存取權杖到期後,再次執行此指令,即可使用已儲存的登入資訊取得新的權杖。

使用 cURL 或 OpenAI SDK 傳送請求時,請將 your-project-id 替換為你的專案 ID。

在 Google Cloud 上傳送 Responses API 請求
PROJECT_ID="your-project-id"
PROJECT_URL="https://aiplatform.googleapis.com/v1/projects/$PROJECT_ID"

curl --fail-with-body "$PROJECT_URL/locations/global/publishers/openai/v1/responses" \
  -H "Authorization: Bearer $GOOGLE_CLOUD_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-luna",
    "input": "Write a one-sentence bedtime story about a unicorn.",
    "store": false
  }'

如果你想透過 Google 的驗證程式庫取得存取權杖,省去在終端中匯出權杖的步驟,請依照 Google 的入門指南操作。該指南說明如何使用應用程式預設憑證(ADC)及排除 API 錯誤。

功能支援情形

下表比較 Google Cloud 與 OpenAI 第一方 API 對各項功能的支援情形。

功能OpenAI APIGoogle Cloud

API 請求

文字生成支援支援
透過 HTTP 串流傳送回應(SSE)支援支援
Responses API 端點支援支援
回應的 Token 用量支援支援
輸入 Token 計數端點支援不支援
即時 WebSocket 連線支援不支援
背景請求支援不支援
續接背景串流支援不支援
Chat Completions API支援不支援
批次處理支援不支援

輸出與推理

使用 JSON 結構描述的結構化輸出支援支援
JSON 模式支援支援
推理強度支援支援
加密推理支援支援
推理摘要支援不支援

工具與整合

用戶端函式呼叫支援支援
平行呼叫工具支援支援
結構化函式引數支援支援
自訂工具支援支援自由格式輸入,也可使用規則運算式限制輸入格式
用戶端工具搜尋支援支援
在用戶端執行的 MCP 與具命名空間的工具支援支援
用戶端 Shell 工具支援支援
託管式網頁搜尋支援不支援
託管式檔案搜尋與向量儲存區支援不支援
託管式程式碼執行支援不支援
伺服器端遠端 MCP支援不支援

文件與媒體

PDF 文字擷取支援支援
內嵌圖像輸入支援支援
圖像生成支援不支援

對話狀態

接續已儲存的對話支援支援
以無狀態方式接續對話支援支援
對話壓縮支援支援
明確控制提示詞快取支援支援

資料保留

你的提示詞與回應不會用於訓練 OpenAI 模型。這些資料預設最多保留 30 天。

如果你需要零資料保留(ZDR),請在導入期間聯絡你的 OpenAI 或 Google Cloud 代表,並等待對方確認可支援這項需求。在請求中設定 store: false 並不會啟用 ZDR。