デベロッパー

Google Gen AI .NET SDK のご紹介

2025年10月30日

https://storage.googleapis.com/gweb-cloudblog-publish/images/image.max-2500x2500.jpg

Mete Atamel

Cloud Developer Advocate

※この投稿は米国時間 2025 年 10 月 24 日に、Google Cloud blog に投稿されたものの抄訳です。

昨年、Google は Google AI における Gemini（Gemini Developer API 経由）と Vertex AI（Vertex AI API 経由）上の Gemini 向けの新しい統合ライブラリとして、Google Gen AI SDK を発表しました。当時は Python SDK のみでした。その後、チームは Go、Node.js、Java への対応を追加するのに忙しくしていましたが、私の好きな言語である C# にはこれまで対応していませんでした。

このたび、Google Gen AI .NET SDK がリリースされたことをお知らせいたします。この SDK を使用すると、C#/.NET を取り扱う開発者は、単一の統合ライブラリで Google AI または Vertex AI の Gemini を使用できます。

詳細を見ていきましょう。

インストール

ライブラリをインストールするには、.NET プロジェクトディレクトリで次のコマンドを実行します。

読み込んでいます...

次のようにパッケージをコードにインポートします。

読み込んでいます...

クライアントの作成

まず、Gemini とやり取りするためのクライアントを作成する必要があります。

Gemini Developer API 経由で、Google AI 上の Gemini をターゲットにできます。

読み込んでいます...

または、Vertex AI 上の Gemini（Vertex AI API 経由）をターゲットにすることができます。

読み込んでいます...

テキストの生成

クライアントが作成されたら、Unary レスポンスでテキストを生成できます。

読み込んでいます...

ストリーミングレスポンスでテキストを生成することもできます。

読み込んでいます...

画像の生成

新しいライブラリでは、画像の生成も簡単です。

読み込んでいます...

https://storage.googleapis.com/gweb-cloudblog-publish/images/skateboard.max-1100x1100.png

構成

もちろん、テキストと画像の生成はすべて高度に構成可能です。

たとえば、テキスト生成のシステム指示やその他の設定を含むレスポンススキーマと生成構成を次のように定義できます。

読み込んでいます...

// Define a response schema
Schema countryInfo = new()
{
    Properties = new Dictionary<string, Schema> {
          {
            "name", new Schema { Type = Type.STRING, Title = "Name" }
          },
          {
            "population", new Schema { Type = Type.INTEGER, Title = "Population" }
          },
          {
            "capital", new Schema { Type = Type.STRING, Title = "Capital" }
          },
          {
            "language", new Schema { Type = Type.STRING, Title = "Language" }
          }
    },
    PropertyOrdering = ["name", "population", "capital", "language"],
    Required = ["name", "population", "capital", "language"],
    Title = "CountryInfo",
    Type = Type.OBJECT
};

// 生成構成を定義する
GenerateContentConfig config = new()
{
    ResponseSchema = countryInfo,
    ResponseMimeType = "application/json",
    SystemInstruction = new Content
    {
        Parts = [
              new Part {Text = "Only answer questions on countries. For everything else, say I don't know."}
        ]
    },
    MaxOutputTokens = 1024,
    Temperature = 0.1,
    TopP = 0.8,
    TopK = 40,
};

var response = await client.Models.GenerateContentAsync(
     model: "gemini-2.5-flash",
     contents: "Give me information about Cyprus",
     config: config);

同様に、画像生成の構成を指定できます。

読み込んでいます...