google-genai-kotlin/com.google.genai.kotlin

Package-level declarations

Types

Provides methods for managing cached content. Instantiating this class is not required. After instantiating a Client, access methods through client.caches directly.

Client

class Client : AutoCloseable

The main entry point for the Google Gen AI SDK.

ClientException

class ClientException(val code: Int, val status: String, message: String) : GenAiApiException

Exception thrown for 4xx client errors from the GenAI API.

Files

class Files

GenAiApiException

open class GenAiApiException(val code: Int, val status: String, message: String) : GenAiException

Exception thrown when the GenAI API returns an error response.

GenAiException

sealed class GenAiException : Exception

Base exception class for all exceptions originating from the GenAI SDK.

GoogleCredentials

expect class GoogleCredentials

Represents the credentials used to authenticate requests to the Google GenAI API.

actual typealias GoogleCredentials = <Error class: unknown class>

Live

class Live

The Live API client for establishing WebSocket connections to Gemini models.

LiveSession

class LiveSession : AutoCloseable

Represents an active WebSocket session with the Live API.

Models

class Models

Provides methods for interacting with the available GenAI models. Instantiating this class is not required. After instantiating a Client, access methods through client.models directly.

Page

class Page<T>(val items: List<T>, val nextPageToken: String?, val sdkHttpResponse: HttpResponse?)

Represents a single immutable page of results.

Pager

class Pager<T>(val name: String, val pageSize: Int? = null, request: suspend (String?) -> Triple<List<T>?, String?, HttpResponse?>) : Flow<T>

A generic pagination class that implements Flow of T items.

ServerException

class ServerException(val code: Int, val status: String, message: String) : GenAiApiException

Exception thrown for 5xx server errors from the GenAI API.

Tunings

class Tunings

Functions

downloadToFile

suspend fun Files.downloadToFile(file: File, outputPath: <Error class: unknown class>, config: DownloadFileConfig? = null)

suspend fun Files.downloadToFile(fileName: String, outputPath: <Error class: unknown class>, config: DownloadFileConfig? = null)

Downloads a file from the API and streams it directly to a local file path.

upload

suspend fun Files.upload(path: <Error class: unknown class>, config: UploadFileConfig? = null): File

Uploads a file at the specified path to the API.

suspend fun Files.upload(file: <Error class: unknown class>, config: UploadFileConfig? = null): File

Uploads a file to the API.