透過 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。
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 API | Google 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。