Package com.google.genkit.plugins.googlegenai

Class TtsModel

java.lang.Object

com.google.genkit.plugins.googlegenai.TtsModel

All Implemented Interfaces:

Model, Action<ModelRequest,ModelResponse,ModelResponseChunk>, Registerable

public class TtsModel
extends Object
implements Model

Text-to-Speech model using Gemini TTS models.

This model uses Gemini's TTS capabilities via responseModalities=AUDIO and speechConfig for voice configuration.

Supported models:

• gemini-2.5-flash-preview-tts
• gemini-2.5-pro-preview-tts

Configuration options (via custom config):

• voiceName - Name of the voice to use (e.g., "Zephyr", "Puck", "Charon", "Kore", etc.)

Available voices: Zephyr, Puck, Charon, Kore, Fenrir, Leda, Orus, Aoede, Callirrhoe, Autonoe, Enceladus, Iapetus, Umbriel, Algieba, Despina, Erinome, Algenib, Rasalgethi, Laomedeia, Achernar, Alnilam, Schedar, Gacrux, Pulcherrima, Achird, Zubenelgenubi, Vindemiatrix, Sadachbia, Sadaltager, Sulafat

Constructor Summary

Constructors

Constructor	Description
TtsModel(String modelName, GoogleGenAIPluginOptions options)	Creates a TtsModel for the specified model.

Method Summary

Modifier and Type	Method	Description
ModelInfo	getInfo()	Gets information about the model's capabilities.
String	getName()	Returns the name of the action.
static boolean	isTtsModel(String modelName)	Checks if the given model name is a supported TTS model.
ModelResponse	run(ActionContext context, ModelRequest request)	Generates a response from the given request.
ModelResponse	run(ActionContext context, ModelRequest request, Consumer<ModelResponseChunk> streamCallback)	Generates a streaming response from the given request.
boolean	supportsStreaming()	Returns whether this model supports streaming.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.genkit.ai.Model

getDesc, getInputSchema, getMetadata, getOutputSchema, getType, register, runJson, runJsonWithTelemetry

Constructor Details

TtsModel

public TtsModel(String modelName,
 GoogleGenAIPluginOptions options)

Creates a TtsModel for the specified model.

Parameters:

modelName - the TTS model name

options - the plugin options

Method Details

getName

public String getName()

Description copied from interface: Action

Returns the name of the action.

Specified by:

getName in interface Action<ModelRequest,ModelResponse,ModelResponseChunk>

Returns:

the action name

getInfo

public ModelInfo getInfo()

Description copied from interface: Model

Gets information about the model's capabilities.

Specified by:

getInfo in interface Model

Returns:

the model info

supportsStreaming

public boolean supportsStreaming()

Description copied from interface: Model

Returns whether this model supports streaming.

Specified by:

supportsStreaming in interface Model

Returns:

true if streaming is supported

run

public ModelResponse run(ActionContext context,
 ModelRequest request)

Description copied from interface: Model

Generates a response from the given request.

Specified by:

run in interface Action<ModelRequest,ModelResponse,ModelResponseChunk>

Specified by:

run in interface Model

Parameters:

context - the action context

request - the model request

Returns:

the model response

run

public ModelResponse run(ActionContext context,
 ModelRequest request,
 Consumer<ModelResponseChunk> streamCallback)

Description copied from interface: Model

Generates a streaming response from the given request.

Specified by:

run in interface Action<ModelRequest,ModelResponse,ModelResponseChunk>

Specified by:

run in interface Model

Parameters:

context - the action context

request - the model request

streamCallback - callback for streaming chunks

Returns:

the final model response

isTtsModel

public static boolean isTtsModel(String modelName)

Checks if the given model name is a supported TTS model.

Parameters:

modelName - the model name to check

Returns:

true if the model is a TTS model