このドキュメントでは、Gemini API の v1 バージョンと v1beta バージョンの違いについて概要を説明します。
- v1: API の安定版。安定版の機能は、メジャー バージョンの存続期間中は完全にサポートされます。互換性を破る変更がある場合は、API の次のメジャー バージョンが作成され、既存のバージョンは一定の期間後に非推奨になります。メジャー バージョンを変更せずに、互換性のない変更が API に導入される場合があります。
- v1beta: このバージョンには、開発中である可能性があり、急速な変更や互換性のない変更が適用される早期アクセス機能が含まれています。また、ベータ版の機能が安定版に移行される保証もありません。この不安定性のため、このバージョンで本番環境アプリケーションをリリースしないことを検討してください。
| 機能 | v1 | v1beta |
|---|---|---|
| コンテンツを生成する - テキストのみの入力 | ||
| コンテンツを生成する - テキストと画像の入力 | ||
| コンテンツの生成 - テキスト出力 | ||
| コンテンツの生成 - マルチターンの会話（チャット） | ||
| コンテンツの生成 - 関数呼び出し | ||
| コンテンツの生成 - ストリーミング | ||
| コンテンツを埋め込む - テキストのみの入力 | ||
| 回答を生成する | ||
| セマンティック レトリバー |
- - サポート対象
- - サポートされることはありません
SDK で API バージョンを構成する
Gemini API SDK のデフォルトは v1beta ですが、次のコードサンプルに示すように API バージョンを設定して、代わりに v1 を使用することもできます。
Python
Python SDK の google.generativeai は v1beta を使用しますが、API バージョンを切り替えるメソッドは提供していません。
低レベルの Python クライアント ライブラリ google.ai.generativelanguage は、他のバージョンを google.ai.generativelanguage_v1 と google.ai.generativelanguage_v1beta の個別のモジュールとして公開します。デフォルトは v1beta です。
import google.ai.generativelanguage_v1 as glm
client = glm.GenerativeServiceClient(
client_options=dict(api_key=YOUR_API_KEY))
response = client.generate_content({
"model": "models/gemini-1.5-flash",
"contents": [ {"parts": [ {"text": "Explain how AI works"}]}]
})
print(type(response).to_dict(response))
Node.js
const { GoogleGenerativeAI } = require("@google/generative-ai");
const genAI = new GoogleGenerativeAI("YOUR_API_KEY");
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' }, { apiVersion: 'v1' });
const prompt = "Explain how AI works";
const result = await model.generateContent(prompt);
console.log(result.response.text());
REST
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": "Write a story about a magic backpack."}]
}]
}'