API 版本說明

本文將概略說明 Gemini API 的 v1 和 v1beta 版本之間的差異。

  • v1：API 穩定版。穩定版中的功能在主要版本生命週期內完全受支援。如有任何重大變更，系統會建立下一個 API 主要版本，並在一段合理時間後淘汰現有版本。API 導入非破壞性變更時，不必變更主要版本。自 2026 年 6 月起，Interactions API 將全面開放使用，並支援 v1。
  • v1beta：這個版本包含正在積極開發的早期功能。v1beta 中的功能可能會根據意見回饋進行調整，但您可以在這些功能升級為穩定版之前搶先試用。
功能 v1 v1beta
Interactions API
生成內容 - 僅輸入文字
生成內容 - 輸入文字和圖片
生成內容 - 文字輸出
生成內容 - 多輪對話 (聊天)
生成內容 - 函式呼叫
生成內容 - 串流
嵌入內容 - 僅輸入文字
生成答案
語意檢索器
  • - 支援
  • - Will never be supported

在 SDK 中設定 API 版本

Gemini API SDK 預設為 v1beta，但您可以明確指定版本，方法是設定 API 版本，如下列程式碼範例所示：

Python

from google import genai

client = genai.Client(http_options={'api_version': 'v1'})

interaction = client.interactions.create(
    model='gemini-3.5-flash',
    input="Explain how AI works",
)

print(interaction.output_text)

JavaScript

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  httpOptions: { apiVersion: "v1" },
});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.5-flash",
    input: "Explain how AI works",
  });
  console.log(interaction.output_text);
}

await main();

REST

curl -X POST "https://generativelanguage.googleapis.com/v1/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.5-flash",
    "input": "Explain how AI works"
  }'