API 版本說明

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

  • v1：API 的穩定版。穩定版中的功能在主要版本的生命週期內享有完整支援。如果有任何重大變更，系統會建立下一個 API 的主要版本，並在合理時間過後淘汰現有版本。您可以在不變更主要版本的情況下，向 API 導入非破壞性變更。
  • v1beta：這個版本包含可能仍在開發階段的搶先體驗功能，且可能會快速變更或發生破壞性變更。我們也無法保證 Beta 版中的功能會移至穩定版。由於此版本不穩定，建議您不要使用這個版本推出正式版應用程式。
功能 v1 v1beta
產生內容 - 僅輸入文字
生成內容 - 文字和圖片輸入
產生內容 - 文字輸出
生成內容 - 多輪對話 (聊天)
生成內容 - 函式呼叫
生成內容 - 串流
嵌入內容 - 僅輸入文字
生成答案
語意擷取工具
  • - 支援
  • - 永遠不會支援

在 SDK 中設定 API 版本

Gemini API SDK 預設為 v1beta，但您可以選擇使用其他版本，方法是設定 API 版本，如以下程式碼範例所示：

PythonJavaScriptREST
from google import genai

client = genai.Client(api_key="YOUR_API_KEY",
                      http_options={'api_version': 'v1alpha'})

response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents="Explain how AI works",
)

print(response.text)

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

const ai = new GoogleGenAI({
  apiKey: "YOUR_API_KEY",
  httpOptions: { apiVersion: "v1alpha" },
});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.5-flash:generateContent?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'