Class GeminiFiles

java.lang.Object

dev.langchain4j.model.googleai.GeminiFiles

public final class GeminiFiles
extends Object

Service for uploading and managing media files with Google AI Gemini.

The Gemini models support multimodal inputs including text, images, audio, videos, and documents. Use this API to upload media files when the total request size exceeds 20 MB.

Files are stored for 48 hours and can be referenced in content generation requests using their URI. The API supports up to 20 GB of files per project, with a maximum of 2 GB per individual file. During the retention period, you can retrieve file metadata but cannot download the files directly.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GeminiFiles.Builder
static final record	GeminiFiles.GeminiFile	Represents a file uploaded to the Gemini API, documentation

Method Summary

Modifier and Type	Method	Description
static GeminiFiles.Builder	builder()
void	deleteFile(String name)	Deletes an uploaded file by name.
GeminiFiles.GeminiFile	getMetadata(String name)	Retrieves metadata for a specific uploaded file.
List<GeminiFiles.GeminiFile>	listFiles()	Lists all uploaded files.
GeminiFiles.GeminiFile	uploadFile(byte[] fileBytes, String mimeType, String name)	Uploads a file to Gemini using the resumable upload protocol.
GeminiFiles.GeminiFile	uploadFile(Path filePath, @Nullable String displayName)	Uploads a file to Gemini using the resumable upload protocol.

Methods inherited from class Object

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

Method Details

builder

public static GeminiFiles.Builder builder()

uploadFile

public GeminiFiles.GeminiFile uploadFile(Path filePath,
 @Nullable String displayName)
                                  throws IOException,
InterruptedException

Uploads a file to Gemini using the resumable upload protocol.

Note: The Files API lets you store up to 20 GB of files per project, with a per-file maximum size of 2 GB. Files are stored for 48 hours.

Parameters:

filePath - path to the file to upload

displayName - optional display name for the file

Throws:

IOException

InterruptedException

uploadFile

public GeminiFiles.GeminiFile uploadFile(byte[] fileBytes,
 String mimeType,
 String name)
                                  throws InterruptedException

Uploads a file to Gemini using the resumable upload protocol.

Note: The Files API lets you store up to 20 GB of files per project, with a per-file maximum size of 2 GB. Files are stored for 48 hours.

Parameters:

fileBytes - byte array that is the file to be uploaded

mimeType - mimetype of the file that is being uploaded

name - optional display name for the file

Throws:

InterruptedException

getMetadata

public GeminiFiles.GeminiFile getMetadata(String name)
                                   throws IOException,
InterruptedException

Retrieves metadata for a specific uploaded file.

Parameters:

name - the name of the file to retrieve metadata for (e.g., "files/abc123")

Throws:

IOException

InterruptedException

listFiles

public List<GeminiFiles.GeminiFile> listFiles()
                                       throws IOException,
InterruptedException

Lists all uploaded files. Returns a list of uploaded files.

Note: The Files API lets you store up to 20 GB of files per project, with a per-file maximum size of 2 GB. Files are stored for 48 hours.

Throws:

IOException

InterruptedException

deleteFile

public void deleteFile(String name)
                throws IOException,
InterruptedException

Deletes an uploaded file by name.

Parameters:

name - the name of the file to delete (e.g., "files/abc123")

Throws:

IOException

InterruptedException