docs: Update examples and README after removing checked exceptions

jaycee-li · copybara-github · commit 5cb6ee5384c5 · 2025-04-02T17:16:17.000-07:00
PiperOrigin-RevId: 743335710
diff --git a/README.md b/README.md
@@ -93,11 +93,9 @@ package <your package name>;
 
 import com.google.genai.Client;
 import com.google.genai.types.GenerateContentResponse;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 public class GenerateContentWithTextInput {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiate the client. The client by default uses the Gemini API. It gets
     // the API key from the environment variable `GOOGLE_API_KEY`.
     Client client = new Client();
@@ -121,11 +119,9 @@ import com.google.genai.Client;
 import com.google.genai.types.Content;
 import com.google.genai.types.GenerateContentResponse;
 import com.google.genai.types.Part;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 public class GenerateContentWithImageInput {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiate the client using Vertex API. The client gets the project and location from the
     // environment variables `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION`.
     Client client = Client.builder().vertexAI(true).build();
@@ -153,11 +149,9 @@ package <your package name>;
 import com.google.genai.Client;
 import com.google.genai.ResponseStream;
 import com.google.genai.types.GenerateContentResponse;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 public class StreamGeneration {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiate the client using Vertex API. The client gets the project and location from the
     // environment variables `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION`.
     Client client = Client.builder().vertexAI(true).build();
@@ -187,12 +181,10 @@ package <your package name>;
 
 import com.google.genai.Client;
 import com.google.genai.types.GenerateContentResponse;
-import java.io.IOException;
 import java.util.concurrent.CompletableFuture;
-import org.apache.http.HttpException;
 
 public class GenerateContentAsync {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client using Gemini API, and sets the API key in the builder.
     Client client = Client.builder().apiKey("your-api-key").build();
 
@@ -226,11 +218,9 @@ import com.google.genai.types.GoogleSearch;
 import com.google.genai.types.Part;
 import com.google.genai.types.SafetySetting;
 import com.google.genai.types.Tool;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 public class GenerateContentWithConfigs {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     Client client = new Client();
 
     // Sets the safety settings in the config.
@@ -280,11 +270,9 @@ import com.google.genai.Client;
 import com.google.genai.types.GenerateContentConfig;
 import com.google.genai.types.GenerateContentResponse;
 import com.google.genai.types.Schema;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 public class GenerateContentWithSchema {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     Client client = new Client();
 
     Schema schema =
diff --git a/examples/src/main/java/com/google/genai/examples/EditImageControlReference.java b/examples/src/main/java/com/google/genai/examples/EditImageControlReference.java
@@ -47,13 +47,11 @@
 import com.google.genai.types.GenerateImagesResponse;
 import com.google.genai.types.Image;
 import com.google.genai.types.ReferenceImage;
-import java.io.IOException;
 import java.util.ArrayList;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to edit an image (Control reference). */
 public class EditImageControlReference {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client using Vertex AI, and sets the project and location in the builder.
     Client client =
         Client.builder()
diff --git a/examples/src/main/java/com/google/genai/examples/EditImageMaskReference.java b/examples/src/main/java/com/google/genai/examples/EditImageMaskReference.java
@@ -33,31 +33,25 @@
  *
  * <p>2. Compile the java package and run the sample code.
  *
- * <p>mvn clean compile exec:java -Dexec.mainClass="com.google.genai.examples.EditImage"
+ * <p>mvn clean compile exec:java -Dexec.mainClass="com.google.genai.examples.EditImageMaskReference"
  */
 package com.google.genai.examples;
 
 import com.google.genai.Client;
-import com.google.genai.types.GenerateImagesConfig;
-import com.google.genai.types.GenerateImagesResponse;
 import com.google.genai.types.EditImageConfig;
 import com.google.genai.types.EditImageResponse;
+import com.google.genai.types.GenerateImagesConfig;
+import com.google.genai.types.GenerateImagesResponse;
 import com.google.genai.types.Image;
 import com.google.genai.types.MaskReferenceConfig;
 import com.google.genai.types.MaskReferenceImage;
 import com.google.genai.types.RawReferenceImage;
 import com.google.genai.types.ReferenceImage;
-import com.google.genai.types.StyleReferenceImage;
-import com.google.genai.types.StyleReferenceConfig;
-import com.google.genai.types.SubjectReferenceConfig;
-import com.google.genai.types.SubjectReferenceImage;
-import java.io.IOException;
 import java.util.ArrayList;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to edit an image (Mask reference). */
 public class EditImageMaskReference {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client using Vertex AI, and sets the project and location in the builder.
     Client client =
         Client.builder()
diff --git a/examples/src/main/java/com/google/genai/examples/EditImageStyleTransfer.java b/examples/src/main/java/com/google/genai/examples/EditImageStyleTransfer.java
@@ -47,13 +47,11 @@
 import com.google.genai.types.ReferenceImage;
 import com.google.genai.types.StyleReferenceConfig;
 import com.google.genai.types.StyleReferenceImage;
-import java.io.IOException;
 import java.util.ArrayList;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to edit an image (Style transfer). */
 public class EditImageStyleTransfer {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client using Vertex AI, and sets the project and location in the builder.
     Client client =
         Client.builder()
diff --git a/examples/src/main/java/com/google/genai/examples/EditImageSubjectReference.java b/examples/src/main/java/com/google/genai/examples/EditImageSubjectReference.java
@@ -47,13 +47,11 @@
 import com.google.genai.types.ReferenceImage;
 import com.google.genai.types.SubjectReferenceConfig;
 import com.google.genai.types.SubjectReferenceImage;
-import java.io.IOException;
 import java.util.ArrayList;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to edit an image (Subject reference). */
 public class EditImageSubjectReference {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client using Vertex AI, and sets the project and location in the builder.
     Client client =
         Client.builder()
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateContent.java b/examples/src/main/java/com/google/genai/examples/GenerateContent.java
@@ -39,12 +39,10 @@
 
 import com.google.genai.Client;
 import com.google.genai.types.GenerateContentResponse;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to generate content. */
 public class GenerateContent {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiate the client. The client by default uses the Gemini Developer API. It gets the API
     // key from the environment variable `GOOGLE_API_KEY`.
     Client client = new Client();
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateContentAsync.java b/examples/src/main/java/com/google/genai/examples/GenerateContentAsync.java
@@ -39,13 +39,11 @@
 
 import com.google.genai.Client;
 import com.google.genai.types.GenerateContentResponse;
-import java.io.IOException;
 import java.util.concurrent.CompletableFuture;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to generate content asynchronously. */
 public class GenerateContentAsync {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client using Gemini Developer API, and sets the API key in the builder.
     Client client = Client.builder().apiKey(System.getenv("GOOGLE_API_KEY")).build();
 
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateContentStream.java b/examples/src/main/java/com/google/genai/examples/GenerateContentStream.java
@@ -40,12 +40,10 @@
 import com.google.genai.Client;
 import com.google.genai.ResponseStream;
 import com.google.genai.types.GenerateContentResponse;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified GenAI Java SDK to generate stream of content. */
 public class GenerateContentStream {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiate the client using Vertex API. The client gets the project and location from the
     // environment variables `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION`.
     Client client = Client.builder().vertexAI(true).build();
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateContentWithConfigs.java b/examples/src/main/java/com/google/genai/examples/GenerateContentWithConfigs.java
@@ -48,12 +48,10 @@
 import com.google.genai.types.Part;
 import com.google.genai.types.SafetySetting;
 import com.google.genai.types.Tool;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to generate content with extra configs. */
 public class GenerateContentWithConfigs {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiate the client using Gemini Developer API.
     Client client = new Client();
 
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateContentWithFunctionCall.java b/examples/src/main/java/com/google/genai/examples/GenerateContentWithFunctionCall.java
@@ -45,12 +45,10 @@
 import com.google.genai.types.GenerateContentConfig;
 import com.google.genai.types.GenerateContentResponse;
 import com.google.genai.types.Schema;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to generate content with function calling. */
 public class GenerateContentWithFunctionCall {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiate the client using Gemini Developer API.
     Client client = new Client();
 
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateContentWithImageInput.java b/examples/src/main/java/com/google/genai/examples/GenerateContentWithImageInput.java
@@ -43,12 +43,10 @@
 import com.google.genai.types.Content;
 import com.google.genai.types.GenerateContentResponse;
 import com.google.genai.types.Part;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to generate content with image input. */
 public class GenerateContentWithImageInput {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiate the client using Vertex API. The client gets the project and location from the
     // environment variables `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION`.
     Client client = Client.builder().vertexAI(true).build();
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateContentWithResponseModality.java b/examples/src/main/java/com/google/genai/examples/GenerateContentWithResponseModality.java
@@ -43,12 +43,10 @@
 import com.google.genai.Client;
 import com.google.genai.types.GenerateContentConfig;
 import com.google.genai.types.GenerateContentResponse;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to generate content with response modality. */
 public class GenerateContentWithResponseModality {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiate the client using Vertex API.
     Client client = Client.builder().vertexAI(true).build();
 
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateContentWithResponseSchema.java b/examples/src/main/java/com/google/genai/examples/GenerateContentWithResponseSchema.java
@@ -44,15 +44,13 @@
 import com.google.genai.types.GenerateContentConfig;
 import com.google.genai.types.GenerateContentResponse;
 import com.google.genai.types.Schema;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 /**
  * GenerateContentWithResponseSchema generates a content and returns a json object by passing a
  * schema.
  */
 public class GenerateContentWithResponseSchema {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     Client client = new Client();
 
     Schema schema =
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateImages.java b/examples/src/main/java/com/google/genai/examples/GenerateImages.java
@@ -41,12 +41,10 @@
 import com.google.genai.types.GenerateImagesConfig;
 import com.google.genai.types.GenerateImagesResponse;
 import com.google.genai.types.Image;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to generate images. */
 public class GenerateImages {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client using Vertex AI, and sets the project and location in the builder.
     Client client =
         Client.builder()
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateImagesAsync.java b/examples/src/main/java/com/google/genai/examples/GenerateImagesAsync.java
@@ -41,13 +41,11 @@
 import com.google.genai.types.GenerateImagesConfig;
 import com.google.genai.types.GenerateImagesResponse;
 import com.google.genai.types.Image;
-import java.io.IOException;
 import java.util.concurrent.CompletableFuture;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to generate images asynchronously. */
 public class GenerateImagesAsync {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client using Vertex AI, and sets the project and location in the builder.
     Client client =
         Client.builder()
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateVideos.java b/examples/src/main/java/com/google/genai/examples/GenerateVideos.java
@@ -41,12 +41,10 @@
 import com.google.genai.types.GenerateVideosConfig;
 import com.google.genai.types.GenerateVideosOperation;
 import com.google.genai.types.Video;
-import java.io.IOException;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to generate videos. */
 public class GenerateVideos {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client using Vertex AI, and sets the project and location in the builder.
     Client client =
         Client.builder()
diff --git a/examples/src/main/java/com/google/genai/examples/GenerateVideosAsync.java b/examples/src/main/java/com/google/genai/examples/GenerateVideosAsync.java
@@ -41,14 +41,12 @@
 import com.google.genai.types.GenerateVideosConfig;
 import com.google.genai.types.GenerateVideosOperation;
 import com.google.genai.types.Video;
-import java.io.IOException;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.ExecutionException;
-import org.apache.http.HttpException;
 
 /** An example of using the Unified Gen AI Java SDK to generate images asynchronously. */
 public class GenerateVideosAsync {
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client using Vertex AI, and sets the project and location in the builder.
     Client client =
         Client.builder()
@@ -82,7 +80,7 @@ public static void main(String[] args) throws IOException, HttpException {
                   Thread.sleep(10000); // Sleep for 10 seconds.
                   try {
                     operation = client.async.operations.getVideoOperation(operation, null).get();
-                  } catch (HttpException | IOException | ExecutionException e) {
+                  } catch (ExecutionException e) {
                     throw new RuntimeException(e);
                   }
                   System.out.println("Waiting for operation to complete...");
diff --git a/examples/src/main/java/com/google/genai/examples/LiveAudioConversationAsync.java b/examples/src/main/java/com/google/genai/examples/LiveAudioConversationAsync.java
@@ -47,17 +47,13 @@
 import com.google.genai.AsyncSession;
 import com.google.genai.Client;
 import com.google.genai.types.Blob;
-import com.google.genai.types.Content;
 import com.google.genai.types.HttpOptions;
 import com.google.genai.types.LiveConnectConfig;
 import com.google.genai.types.LiveSendRealtimeInputParameters;
-import com.google.genai.types.LiveServerContent;
 import com.google.genai.types.LiveServerMessage;
 import com.google.genai.types.PrebuiltVoiceConfig;
 import com.google.genai.types.SpeechConfig;
 import com.google.genai.types.VoiceConfig;
-import java.io.IOException;
-import java.util.Optional;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.ExecutorService;
@@ -70,7 +66,6 @@
 import javax.sound.sampled.LineUnavailableException;
 import javax.sound.sampled.SourceDataLine;
 import javax.sound.sampled.TargetDataLine;
-import org.apache.http.HttpException;
 
 /** Example of using the live module for a streaming audio conversation. */
 public class LiveAudioConversationAsync {
@@ -136,8 +131,7 @@ private static void sendMicrophoneAudio() {
     System.out.println("Microphone reading stopped.");
   }
 
-  public static void main(String[] args)
-      throws IOException, HttpException, LineUnavailableException {
+  public static void main(String[] args) throws LineUnavailableException {
 
     // Instantiates the client.
     Client client =
diff --git a/examples/src/main/java/com/google/genai/examples/LiveTextConversationAsync.java b/examples/src/main/java/com/google/genai/examples/LiveTextConversationAsync.java
@@ -49,15 +49,13 @@
 import com.google.genai.types.LiveServerMessage;
 import com.google.genai.types.Part;
 import java.io.Console;
-import java.io.IOException;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.ExecutionException;
-import org.apache.http.HttpException;
 
 /** Example of using the live module to send and receive messages asynchronously. */
 public class LiveTextConversationAsync {
 
-  public static void main(String[] args) throws IOException, HttpException {
+  public static void main(String[] args) {
     // Instantiates the client.
     Client client =
         Client.builder().httpOptions(HttpOptions.builder().apiVersion("v1alpha").build()).build();
diff --git a/examples/src/main/java/com/google/genai/examples/LiveTextToTextGenerationAsync.java b/examples/src/main/java/com/google/genai/examples/LiveTextToTextGenerationAsync.java
diff --git a/examples/src/main/java/com/google/genai/examples/UpscaleImage.java b/examples/src/main/java/com/google/genai/examples/UpscaleImage.java
diff --git a/examples/src/main/java/com/google/genai/examples/UpscaleImageAsync.java b/examples/src/main/java/com/google/genai/examples/UpscaleImageAsync.java
