本文將概要說明 Gemini API 的 v1 和 v1beta 版本差異。
- v1：API 穩定版。穩定版中的功能在主要版本生命週期內都可獲得完整支援。如有任何重大變更，系統會建立下一個 API 主要版本，並在一段合理時間後淘汰現有版本。API 可能會導入非破壞性變更，但不會變更主要版本。
- v1beta：這個版本包含可能仍在開發中的搶先體驗功能，且可能快速發生破壞性變更。此外，我們無法保證 Beta 版功能會移至穩定版。由於這個版本不穩定，建議您不要使用這個版本啟動正式版應用程式。
| 功能 | v1 | v1beta |
|---|---|---|
| 生成內容 - 僅輸入文字 | ||
| 生成內容 - 輸入文字和圖片 | ||
| 生成內容 - 文字輸出 | ||
| 生成內容 - 多輪對話 (聊天) | ||
| 生成內容 - 函式呼叫 | ||
| 生成內容 - 串流 | ||
| 嵌入內容 - 僅限文字輸入 | ||
| 生成答案 | ||
| 語意擷取器 |
- - 支援
- - 永遠不會支援
在 SDK 中設定 API 版本
Gemini API SDK 預設為 v1beta，但您可以選擇使用其他版本，方法是設定 API 版本，如下列程式碼範例所示：
Python
from google import genai
client = genai.Client(http_options={'api_version': 'v1alpha'})
response = client.models.generate_content(
model='gemini-2.0-flash',
contents="Explain how AI works",
)
print(response.text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
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();
REST
curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.5-flash:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [{
"parts":[{"text": "Explain how AI works."}]
}]
}'