【解説】Gemini API Python新SDK｜google-genai 3.0の変更点

Gemini APIをPythonで呼ぶ書き方が変わりました。11月6日公開のgoogle-genai 3.0.0で、新しく書くコードの前提が変わっています。

呼び出しはinteractionsへ

新しく書くコードは、クライアントのインタラクションズのcreateで呼び出します。2026年6月にInteractions APIが正式版になり、従来のgenerate_contentはレガシー扱いになりました。ただし既存のコードは、今も問題なく動きます。

Python 3.11以上が必要

3.0.0から、動作にはPython 3.11以上が必要です。既定のAPIバージョンとHTTPクライアントも変わりました。3.10の環境で更新すると、エラーにならずに2.33.0が入ります。導入したあとは、入った版を確かめてください。

保存と再試行を決める

業務で使う前に決めることが2つあります。やり取りは既定でサーバーに保存され、有料枠は55日、無料枠は1日です。残したくない処理には、storeをFalseにします。また、SDKが429と5xxを自動で再試行するため、自前のリトライは重ねません。

コードの全文や関数呼び出しの手順は、記事で順に確認できます。