From 9ef72153d332d513bdc2a9ae3bf388c875f32ab3 Mon Sep 17 00:00:00 2001
From: mukunda katta <mukunda.vjcs6@gmail.com>
Date: Fri, 15 May 2026 08:12:18 -0700
Subject: [PATCH] docs: explain Gemini Developer API vs Enterprise Agent
 Platform

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index ed8d78f93a..32c32237a1 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,22 @@ The Google Gen AI SDK provides support for both the
 [Gemini Enterprise Agent Platform](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/overview)
  implementations of the Gemini API.
 
+<details>
+<summary>Gemini Developer API vs Gemini Enterprise Agent Platform</summary>
+
+Use the **Gemini Developer API** when you want the simplest path for prototypes
+or applications that authenticate with an API key from Google AI Studio.
+
+Use **Gemini Enterprise Agent Platform** when your application should run on
+Google Cloud infrastructure, use Google Cloud authentication, and be associated
+with a specific Google Cloud project and location. This path requires setting
+`enterprise: true` when you initialize the SDK.
+
+Both paths use the same `GoogleGenAI` client and SDK methods; the main
+difference is how the client is initialized and authenticated.
+
+</details>
+
 ### Gemini Developer API
 
 For server-side applications, initialize using an API key, which can