Package io.github.glaforge.gemini.interactions

Class GeminiInteractionsClient

java.lang.Object

io.github.glaforge.gemini.interactions.GeminiInteractionsClient

public class GeminiInteractionsClient
extends Object

Client for the Gemini Interactions API.

This client allows you to interact with the Gemini API to create interactions, retrieve past interactions, and more.

Example usage:

 GeminiInteractionsClient client = GeminiInteractionsClient.builder()
     .apiKey(System.getenv("GEMINI_API_KEY"))
     .build();

 InteractionParams.Request request = ModelInteractionParams.builder()
     .model("gemini-2.5-flash")
     .input("Hello, world!")
     .build();

 Interaction interaction = client.create(request);
 System.out.println(interaction.outputs().get(0).text());
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GeminiInteractionsClient.Builder	Builder for GeminiInteractionsClient.

Method Summary

Modifier and Type	Method	Description
static GeminiInteractionsClient.Builder	builder()	Creates a new builder for the GeminiInteractionsClient.
Interaction	cancel(String id)	Cancels an interaction by ID.
Interaction	create(InteractionParams.Request request)	Creates a new interaction.
void	delete(String id)	Deletes an interaction by ID.
Interaction	get(String id)	Retrieves an interaction by ID.
Interaction	get(String id, boolean includeInput)	Retrieves an interaction by ID, optionally including the original input.
Stream<Events>	stream(InteractionParams.Request request)	Creates a streaming interaction.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

builder

public static GeminiInteractionsClient.Builder builder()

Creates a new builder for the GeminiInteractionsClient.

Returns:

A new builder.

create

public Interaction create(InteractionParams.Request request)

Creates a new interaction.

Parameters:

request - The interaction request parameters (Model or Agent).

Returns:

The created Interaction.

Throws:

GeminiInteractionsException - If the API request fails or an error occurs.

See Also:

• Create Interaction API Reference

stream

public Stream<Events> stream(InteractionParams.Request request)

Creates a streaming interaction.

Parameters:

request - The interaction request parameters (Model or Agent).

Returns:

A Stream of Events.

Throws:

GeminiInteractionsException - If the API request fails or an error occurs.

get

public Interaction get(String id)

Retrieves an interaction by ID.

Parameters:

id - The interaction ID.

Returns:

The Interaction.

Throws:

GeminiInteractionsException - If the API request fails or an error occurs.

See Also:

• Get Interaction API Reference

get

public Interaction get(String id,
 boolean includeInput)

Retrieves an interaction by ID, optionally including the original input.

Parameters:

id - The interaction ID.

includeInput - Whether to include the input in the response.

Returns:

The Interaction.

Throws:

GeminiInteractionsException - If the API request fails or an error occurs.

See Also:

• Get Interaction API Reference

delete

public void delete(String id)

Deletes an interaction by ID.

Parameters:

id - The interaction ID.

Throws:

GeminiInteractionsException - If the API request fails or an error occurs.

See Also:

• Delete Interaction API Reference

cancel

public Interaction cancel(String id)

Cancels an interaction by ID.

Parameters:

id - The interaction ID.

Returns:

The updated Interaction (status should be cancelled).

Throws:

GeminiInteractionsException - If the API request fails or an error occurs.

See Also:

• Cancel Interaction API Reference