google-adk-kotlin-core/com.google.adk.kt.models/Gemini

Gemini

Implementation of Model that interacts with Google Gemini models using the GenAI SDK.

This class provides functionality to generate content from Gemini models, supporting both unary and streaming responses. It can be configured to use either a Google AI API key or Vertex AI credentials for authentication.

GenAI SDK based Gemini currently prevents usage of API_KEY and GoogleCredentials on Android. Use Firebase AI instead.

Constructors

Gemini

@JvmOverloads

constructor(client: Client, name: String, speechConfig: SpeechConfig? = null)

Creates a Gemini from a preconfigured GenAI SDK Client, for callers that need a custom transport or auth. Each generate request and live connection appends ADK's tracking tag to the client's user-agent and x-goog-api-client headers. The SDK matches these names exactly, so a client header spelled User-Agent replaces the merged value.

@JvmOverloads

constructor(name: String, apiKey: String? = null, speechConfig: SpeechConfig? = null)

Creates a Gemini instance using a Google AI API key for authentication. Its client retries transient failures with the GenAI SDK's default retry options; pass your own Client for other retry settings.

@JvmOverloads

constructor(name: String, vertexCredentials: VertexCredentials, speechConfig: SpeechConfig? = null)

Creates a Gemini instance using Vertex AI credentials for authentication. Its client retries transient failures with the GenAI SDK's default retry options; pass your own Client for other retry settings.

Types

Builder

class Builder

Fluent builder for Gemini, provided primarily for Java callers. Any property left unset falls back to the same default as the constructor.

Companion

object Companion

Properties

name

open override val name: String

The name of the model.

speechConfig

val speechConfig: SpeechConfig?

The speech config for live sessions opened by this model. When set, it replaces the request's own speech config at connect, as in ADK Python.

Functions

connect

@ExperimentalLiveApi

open suspend override fun connect(request: LlmRequest): LiveConnection

Opens a live session configured by LlmRequest.liveConnectConfig (using request.model when set), returning once the server confirms setup and throwing if the server refuses it. If the caller is cancelled while the session opens, the session is closed in the background. Reconnection is not handled here, though a Vertex AI resume with transparent unset asks for transparent resumption.

generateContent

open override fun generateContent(request: LlmRequest, stream: Boolean = false): Flow<LlmResponse>

Generates content for the given LlmRequest. This returns a Flow of LlmResponses.