feat: add video modality support and document usage with Gemini Omni Flash

Author: glaforge

BLOG.md

@@ -0,0 +1,97 @@
+---
+title: "Generating Media with Nano Banana 2 Lite and Gemini Omni Flash in Java"
+date: 2026-06-30T20:00:00+02:00
+draft: false
+tags: ["Java", "Gemini", "AI", "Generative AI"]
+categories: ["Programming"]
+---
+
+Google just announced the launch of some incredibly exciting new models: **Nano Banana 2 Lite** (the fastest, most cost-efficient Gemini Image model yet) and **Gemini Omni Flash** for high-quality video and conversational editing. You can read all about the announcement on the [Google Blog](https://blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-omni-flash-nano-banana-2-lite/).
+
+As soon as I saw the news, I couldn't wait to get my hands dirty. I wanted to see how easy it would be to generate images and videos using the [Gemini Interactions API Java SDK](https://github.com/glaforge/gemini-interactions-api-sdk). 
+
+Spoiler alert: it's incredibly simple! In this post, I'll walk you through how to invoke both of these models to generate an image and a video natively in Java.
+
+## Setting Up
+
+First, make sure you have the Gemini Interactions API SDK in your project. If you're using Maven, just add the dependency:
+
+```xml
+<dependency>
+    <groupId>io.github.glaforge</groupId>
+    <artifactId>gemini-interactions-api-sdk</artifactId>
+    <version>0.11.0</version>
+</dependency>
+```
+
+Also, ensure that your `GEMINI_API_KEY` environment variable is set.
+
+## Generating an Image with Nano Banana 2 Lite
+
+The model identifier for the new image model is `gemini-3.1-flash-lite-image`. Generating an image is as simple as creating a `ModelInteractionParams` request, specifying the `IMAGE` response modality, and extracting the binary data from the interaction.
+
+```java
+import io.github.glaforge.gemini.interactions.GeminiInteractionsClient;
+import io.github.glaforge.gemini.interactions.model.*;
+import io.github.glaforge.gemini.interactions.model.InteractionParams.ModelInteractionParams;
+import io.github.glaforge.gemini.interactions.model.Interaction.Modality;
+import java.nio.file.Files;
+import java.nio.file.Paths;
+
+public class MediaGenerator {
+    public static void main(String[] args) throws Exception {
+        // Initialize the client
+        GeminiInteractionsClient client = GeminiInteractionsClient.builder()
+            .apiKey(System.getenv("GEMINI_API_KEY"))
+            .build();
+
+        // Prepare the image request
+        ModelInteractionParams imageRequest = ModelInteractionParams.builder()
+            .model("gemini-3.1-flash-lite-image")
+            .input("A highly detailed realistic banana wearing sunglasses on a beach")
+            .responseModalities(Modality.IMAGE)
+            .build();
+            
+        // Execute the interaction and save the image
+        Interaction imageInteraction = client.create(imageRequest);
+        
+        if (imageInteraction.outputImage() != null) {
+            byte[] imageData = imageInteraction.outputImage().data();
+            Files.write(Paths.get("nano-banana.png"), imageData);
+            System.out.println("Image saved successfully!");
+        }
+    }
+}
+```
+
+## Generating a Video with Gemini Omni Flash
+
+The video generation process is practically identical! The model identifier for Omni Flash is `gemini-omni-flash-preview`. We simply switch the model name and update the `responseModalities` to `Modality.VIDEO`.
+
+*Note: You may need to ensure you're on the absolute latest version of the SDK to support the `VIDEO` modality!*
+
+```java
+// Prepare the video request
+ModelInteractionParams videoRequest = ModelInteractionParams.builder()
+    .model("gemini-omni-flash-preview")
+    .input("A banana jumping into a pool of water")
+    .responseModalities(Modality.VIDEO)
+    .build();
+    
+// Execute the interaction and save the video
+Interaction videoInteraction = client.create(videoRequest);
+
+if (videoInteraction.outputVideo() != null) {
+    byte[] videoData = videoInteraction.outputVideo().data();
+    Files.write(Paths.get("omni-banana.mp4"), videoData);
+    System.out.println("Video saved successfully!");
+}
+```
+
+## The Results!
+
+With just a few lines of Java code, the SDK abstracts away all the HTTP calls and multipart response parsing, giving you the direct byte arrays for your generated media.
+
+*(If you are following along, don't forget to embed the generated `nano-banana.png` and `omni-banana.mp4` files here to show off the results!)*
+
+The Interactions API keeps getting more powerful, and the Java SDK is keeping right up with it. Let me know what you end up building with Nano Banana 2 Lite and Omni Flash!

skills/gemini-interactions-java-api/SKILL.md

@@ -104,6 +104,32 @@ if (image != null) {
 }
 ```
 
+### Multimodal Video Generation (Gemini Omni Flash)
+
+Generate videos and extract the video data.
+
+```java
+import io.github.glaforge.gemini.interactions.GeminiInteractionsClient;
+import io.github.glaforge.gemini.interactions.model.*;
+import io.github.glaforge.gemini.interactions.model.Content.*;
+import io.github.glaforge.gemini.interactions.model.InteractionParams.ModelInteractionParams;
+import io.github.glaforge.gemini.interactions.model.Interaction.Modality;
+
+GeminiInteractionsClient client = GeminiInteractionsClient.builder().apiKey(System.getenv("GEMINI_API_KEY")).build();
+
+ModelInteractionParams request = ModelInteractionParams.builder()
+    .model("gemini-omni-flash-preview")
+    .input("A highly detailed cinematic shot of a futuristic banana.")
+    .responseModalities(Modality.VIDEO)
+    .build();
+
+Interaction interaction = client.create(request);
+Content.VideoContent video = interaction.outputVideo();
+if (video != null) {
+    System.out.println("Video generated with " + video.data().length + " bytes.");
+}
+```
+
 ### Stateful Conversation (Multi-Turn)
 
 Use `store(true)` to persist the conversation in the cloud, and `previousInteractionId` to continue the thread.

src/main/java/io/github/glaforge/gemini/interactions/model/Interaction.java

@@ -229,7 +229,9 @@ public enum Modality {
         /** Image modality. */
         @JsonProperty("image") IMAGE,
         /** Audio modality. */
-        @JsonProperty("audio") AUDIO
+        @JsonProperty("audio") AUDIO,
+        /** Video modality. */
+        @JsonProperty("video") VIDEO
     }
 
     /**