Package com.google.genai

Class AsyncModels

java.lang.Object

com.google.genai.AsyncModels

public final class AsyncModels
extends Object

Async module of Models

Constructor Summary

Constructors

Constructor	Description
AsyncModels(com.google.genai.ApiClient apiClient)

Method Summary

Modifier and Type	Method	Description
CompletableFuture<ComputeTokensResponse>	computeTokens(String model, List<Content> contents, ComputeTokensConfig config)
CompletableFuture<CountTokensResponse>	countTokens(String model, List<Content> contents, CountTokensConfig config)
CompletableFuture<EditImageResponse>	editImage(String model, String prompt, List<ReferenceImage> referenceImages, EditImageConfig config)	Asynchronously edits an image given a GenAI model, a prompt, and a list of reference images.
CompletableFuture<EmbedContentResponse>	embedContent(String model, String text, EmbedContentConfig config)	Asynchronously embeds content given a GenAI model and a text string.
CompletableFuture<EmbedContentResponse>	embedContent(String model, List<String> texts, EmbedContentConfig config)	Asynchronously embeds content given a GenAI model and a list of text strings.
CompletableFuture<GenerateContentResponse>	generateContent(String model, Content content, GenerateContentConfig config)	Asynchronously generates content given a GenAI model and a content object.
CompletableFuture<GenerateContentResponse>	generateContent(String model, String text, GenerateContentConfig config)	Asynchronously generates content given a GenAI model and a text string.
CompletableFuture<GenerateContentResponse>	generateContent(String model, List<Content> contents, GenerateContentConfig config)	Asynchronously generates content given a GenAI model and a content object.
CompletableFuture<ResponseStream<GenerateContentResponse>>	generateContentStream(String model, Content content, GenerateContentConfig config)	Asynchronously generates content with streaming support given a GenAI model and a content object.
CompletableFuture<ResponseStream<GenerateContentResponse>>	generateContentStream(String model, String text, GenerateContentConfig config)	Asynchronously generates content with streaming support given a GenAI model and a text string.
CompletableFuture<ResponseStream<GenerateContentResponse>>	generateContentStream(String model, List<Content> contents, GenerateContentConfig config)	Asynchronously generates content with streaming support given a GenAI model and a content object.
CompletableFuture<GenerateImagesResponse>	generateImages(String model, String prompt, GenerateImagesConfig config)	Asynchronously generates images given a GenAI model and a prompt.
CompletableFuture<GenerateVideosOperation>	generateVideos(String model, String prompt, Image image, GenerateVideosConfig config)	Asynchronously generates videos given a GenAI model, and a prompt or an image.
CompletableFuture<UpscaleImageResponse>	upscaleImage(String model, Image image, String upscaleFactor, UpscaleImageConfig config)	Asynchronously upscales an image given a GenAI model and an image and an upscale factor.

Methods inherited from class java.lang.Object

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

Constructor Details

AsyncModels

public AsyncModels(com.google.genai.ApiClient apiClient)

Method Details

countTokens

public CompletableFuture<CountTokensResponse> countTokens(String model,
 List<Content> contents,
 CountTokensConfig config)

computeTokens

public CompletableFuture<ComputeTokensResponse> computeTokens(String model,
 List<Content> contents,
 ComputeTokensConfig config)

generateVideos

public CompletableFuture<GenerateVideosOperation> generateVideos(String model,
 String prompt,
 Image image,
 GenerateVideosConfig config)

Asynchronously generates videos given a GenAI model, and a prompt or an image.

This method is experimental.

Parameters:

model - the name of the GenAI model to use for generating videos

prompt - the text prompt for generating the videos. Optional for image to video use cases.

image - the input image for generating the videos. Optional if prompt is provided.

config - a GenerateVideosConfig instance that specifies the optional configurations

Returns:

a GenerateVideosOperation instance that contains the generated videos.

generateContent

public CompletableFuture<GenerateContentResponse> generateContent(String model,
 List<Content> contents,
 GenerateContentConfig config)

Asynchronously generates content given a GenAI model and a content object.

Parameters:

model - the name of the GenAI model to use for generation

contents - a List<Content> to send to the generative model

config - a GenerateContentConfig instance that specifies the optional configurations

Returns:

a GenerateContentResponse instance that contains response contents and other metadata

generateContent

public CompletableFuture<GenerateContentResponse> generateContent(String model,
 Content content,
 GenerateContentConfig config)

Asynchronously generates content given a GenAI model and a content object.

Parameters:

model - the name of the GenAI model to use for generation

content - a Content to send to the generative model

config - a GenerateContentConfig instance that specifies the optional configurations

Returns:

a GenerateContentResponse instance that contains response contents and other metadata

generateContent

public CompletableFuture<GenerateContentResponse> generateContent(String model,
 String text,
 GenerateContentConfig config)

Asynchronously generates content given a GenAI model and a text string.

Parameters:

model - the name of the GenAI model to use for generation

text - the text string to send to the generative model

config - a GenerateContentConfig instance that specifies the optional configurations

Returns:

a GenerateContentResponse instance that contains response contents and other metadata

generateContentStream

public CompletableFuture<ResponseStream<GenerateContentResponse>> generateContentStream(String model,
 List<Content> contents,
 GenerateContentConfig config)

Asynchronously generates content with streaming support given a GenAI model and a content object.

Parameters:

model - the name of the GenAI model to use for generation

contents - a List<Content> to send to the generative model

config - a GenerateContentConfig instance that specifies the optional configurations

Returns:

a GenerateContentResponse instance that contains response contents and other metadata

generateContentStream

public CompletableFuture<ResponseStream<GenerateContentResponse>> generateContentStream(String model,
 Content content,
 GenerateContentConfig config)

Asynchronously generates content with streaming support given a GenAI model and a content object.

Parameters:

model - the name of the GenAI model to use for generation

content - a Content to send to the generative model

config - a GenerateContentConfig instance that specifies the optional configurations

Returns:

a GenerateContentResponse instance that contains response contents and other metadata

generateContentStream

public CompletableFuture<ResponseStream<GenerateContentResponse>> generateContentStream(String model,
 String text,
 GenerateContentConfig config)

Asynchronously generates content with streaming support given a GenAI model and a text string.

Parameters:

model - the name of the GenAI model to use for generation

text - the text string to send to the generative model

config - a GenerateContentConfig instance that specifies the optional configurations

Returns:

a GenerateContentResponse instance that contains response contents and other metadata

generateImages

public CompletableFuture<GenerateImagesResponse> generateImages(String model,
 String prompt,
 GenerateImagesConfig config)

Asynchronously generates images given a GenAI model and a prompt.

Parameters:

model - the name of the GenAI model to use for generating images

prompt - the prompt to generate images

config - a GenerateImagesConfig instance that specifies the optional configurations

Returns:

a GenerateImagesResponse instance that contains the generated images.

editImage

public CompletableFuture<EditImageResponse> editImage(String model,
 String prompt,
 List<ReferenceImage> referenceImages,
 EditImageConfig config)

Asynchronously edits an image given a GenAI model, a prompt, and a list of reference images.

Parameters:

model - the name of the GenAI model to use for editing capabilities

prompt - the prompt to edit the image

referenceImages - a List<ReferenceImage> to send to use for editing. The 5 types of reference images are: RawReferenceImage, MaskReferenceImage, ControlReferenceImage, StyleReferenceImage, SubjectReferenceImage,

config - a EditImageConfig instance that specifies the optional configurations

Returns:

a EditImageResponse instance that contains the edited image.

upscaleImage

public CompletableFuture<UpscaleImageResponse> upscaleImage(String model,
 Image image,
 String upscaleFactor,
 UpscaleImageConfig config)

Asynchronously upscales an image given a GenAI model and an image and an upscale factor.

Parameters:

model - the name of the GenAI model to use for upscaling

image - a Image to send to the generative model

upscaleFactor - the factor to upscale the image

config - a UpscaleImageConfig instance that specifies the optional configurations

Returns:

a UpscaleImageResponse instance that contains the upscaled image.

embedContent

public CompletableFuture<EmbedContentResponse> embedContent(String model,
 String text,
 EmbedContentConfig config)

Asynchronously embeds content given a GenAI model and a text string.

Parameters:

model - the name of the GenAI model to use for embedding

text - the text string to send to the embedding model

Returns:

a EmbedContentResponse instance that contains the embedding.

embedContent

public CompletableFuture<EmbedContentResponse> embedContent(String model,
 List<String> texts,
 EmbedContentConfig config)

Asynchronously embeds content given a GenAI model and a list of text strings.

Parameters:

model - the name of the GenAI model to use for embedding

texts - the list of text strings to send to the embedding model

Returns:

a EmbedContentResponse instance that contains the embedding.