@google/genai 0.8.0 → 0.10.0

package/dist/genai.d.ts

@@ -46,11 +46,11 @@ declare class ApiClient {
     private shouldPrependVertexProjectPath;
     request(request: HttpRequest): Promise<HttpResponse>;
     private patchHttpOptions;
-    requestStream(request: HttpRequest): Promise<any>;
+    requestStream(request: HttpRequest): Promise<AsyncGenerator<HttpResponse>>;
     private includeExtraHttpOptionsToRequestInit;
     private unaryApiCall;
     private streamApiCall;
-    processStreamResponse(response: Response): AsyncGenerator<any>;
+    processStreamResponse(response: Response): AsyncGenerator<HttpResponse>;
     private apiCall;
     getDefaultHeaders(): Record<string, string>;
     private getHeadersInternal;
@@ -164,6 +164,14 @@ export declare interface AutomaticActivityDetection {
 declare class BaseModule {
 }
 
+/**
+ * Parameters for setting the base URLs for the Gemini API and Vertex AI API.
+ */
+export declare interface BaseUrlParameters {
+    geminiUrl?: string;
+    vertexUrl?: string;
+}
+
 /** Content blob. */
 declare interface Blob_2 {
     /** Required. Raw bytes. */
@@ -173,6 +181,8 @@ declare interface Blob_2 {
 }
 export { Blob_2 as Blob }
 
+export declare type BlobImageUnion = Blob_2;
+
 /** Output only. Blocked reason. */
 export declare enum BlockedReason {
     BLOCKED_REASON_UNSPECIFIED = "BLOCKED_REASON_UNSPECIFIED",
@@ -237,8 +247,8 @@ export declare class Caches extends BaseModule {
      *
      * @remarks
      * Context caching is only supported for specific models. See [Gemini
-     * Developer API reference] (https://ai.google.dev/gemini-api/docs/caching?lang=node/context-cac)
-     * and [Vertex AI reference] (https://cloud.google.com/vertex-ai/generative-ai/docs/context-cache/context-cache-overview#supported_models)
+     * Developer API reference](https://ai.google.dev/gemini-api/docs/caching?lang=node/context-cac)
+     * and [Vertex AI reference](https://cloud.google.com/vertex-ai/generative-ai/docs/context-cache/context-cache-overview#supported_models)
      * for more information.
      *
      * @param params - The parameters for the create request.
@@ -487,6 +497,13 @@ export declare interface CodeExecutionResult {
 export declare interface ComputeTokensConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
 }
 
 /** Parameters for computing tokens. */
@@ -540,7 +557,7 @@ export declare interface ContentEmbeddingStatistics {
     tokenCount?: number;
 }
 
-export declare type ContentListUnion = ContentUnion[] | ContentUnion;
+export declare type ContentListUnion = Content | Content[] | PartUnion | PartUnion[];
 
 export declare type ContentUnion = Content | PartUnion[] | PartUnion;
 
@@ -595,6 +612,13 @@ export declare enum ControlReferenceType {
 export declare interface CountTokensConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     /** Instructions for the model to steer it toward better performance.
      */
     systemInstruction?: ContentUnion;
@@ -631,6 +655,13 @@ export declare class CountTokensResponse {
 export declare interface CreateCachedContentConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     /** The TTL for this resource. The expiration time is computed: now + TTL. It is a duration string, with up to nine fractional digits, terminated by 's'. Example: "3.5s". */
     ttl?: string;
     /** Timestamp of when this resource is considered expired. Uses RFC 3339 format, Example: 2014-10-02T15:01:23Z. */
@@ -692,6 +723,13 @@ export declare interface CreateChatParameters {
 export declare interface CreateFileConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
 }
 
 /** Generates the parameters for the private _create method. */
@@ -762,6 +800,13 @@ export declare function createUserContent(partOrString: PartListUnion | string):
 export declare interface DeleteCachedContentConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
 }
 
 /** Parameters for caches.delete method. */
@@ -782,6 +827,13 @@ export declare class DeleteCachedContentResponse {
 export declare interface DeleteFileConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
 }
 
 /** Generates the parameters for the get method. */
@@ -800,6 +852,13 @@ export declare class DeleteFileResponse {
 export declare interface DownloadFileConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
 }
 
 /** Describes the options to customize dynamic retrieval. */
@@ -819,6 +878,13 @@ export declare enum DynamicRetrievalConfigMode {
 export declare interface EmbedContentConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     /** Type of task for which the embedding will be used.
      */
     taskType?: string;
@@ -897,9 +963,24 @@ export declare interface ExecutableCode {
     language?: Language;
 }
 
+/** Options for feature selection preference. */
+export declare enum FeatureSelectionPreference {
+    FEATURE_SELECTION_PREFERENCE_UNSPECIFIED = "FEATURE_SELECTION_PREFERENCE_UNSPECIFIED",
+    PRIORITIZE_QUALITY = "PRIORITIZE_QUALITY",
+    BALANCED = "BALANCED",
+    PRIORITIZE_COST = "PRIORITIZE_COST"
+}
+
 export declare interface FetchPredictOperationConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
 }
 
 /** Parameters for the fetchPredictOperation method. */
@@ -1103,6 +1184,7 @@ export declare enum FinishReason {
     MAX_TOKENS = "MAX_TOKENS",
     SAFETY = "SAFETY",
     RECITATION = "RECITATION",
+    LANGUAGE = "LANGUAGE",
     OTHER = "OTHER",
     BLOCKLIST = "BLOCKLIST",
     PROHIBITED_CONTENT = "PROHIBITED_CONTENT",
@@ -1174,6 +1256,13 @@ export declare class FunctionResponse {
 export declare interface GenerateContentConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     /** Instructions for the model to steer it toward better performance.
      For example, "Answer as concisely as possible" or "Don't use technical
      terms in your response".
@@ -1239,6 +1328,9 @@ export declare interface GenerateContentConfig {
     /** Configuration for model router requests.
      */
     routingConfig?: GenerationConfigRoutingConfig;
+    /** Configuration for model selection.
+     */
+    modelSelectionConfig?: ModelSelectionConfig;
     /** Safety settings in the request to block unsafe content in the
      response.
      */
@@ -1328,6 +1420,17 @@ export declare class GenerateContentResponse {
      * ```
      */
     get text(): string | undefined;
+    /**
+     * Returns the concatenation of all inline data parts from the first candidate
+     * in the response.
+     *
+     * @remarks
+     * If there are multiple candidates in the response, the inline data from the
+     * first one will be returned. If there are non-inline data parts in the
+     * response, the concatenation of all inline data parts will be returned, and
+     * a warning will be logged.
+     */
+    get data(): string | undefined;
     /**
      * Returns the function calls from the first candidate in the response.
      *
@@ -1488,6 +1591,13 @@ export declare interface GeneratedVideo {
 export declare interface GenerateImagesConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     /** Cloud Storage URI used to store the generated images.
      */
     outputGcsUri?: string;
@@ -1569,6 +1679,13 @@ export declare class GenerateImagesResponse {
 export declare interface GenerateVideosConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     /** Number of output videos. */
     numberOfVideos?: number;
     /** The gcs bucket where to save the generated videos. */
@@ -1691,6 +1808,13 @@ export declare interface GenerationConfigRoutingConfigManualRoutingMode {
 export declare interface GetCachedContentConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
 }
 
 /** Parameters for caches.get method. */
@@ -1707,6 +1831,13 @@ export declare interface GetCachedContentParameters {
 export declare interface GetFileConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
 }
 
 /** Generates the parameters for the get method. */
@@ -1721,6 +1852,13 @@ export declare interface GetFileParameters {
 export declare interface GetModelConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
 }
 
 export declare interface GetModelParameters {
@@ -1732,6 +1870,13 @@ export declare interface GetModelParameters {
 export declare interface GetOperationConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
 }
 
 /** Parameters for the GET method. */
@@ -2022,6 +2167,10 @@ declare interface HttpRequest {
      * Optional set of customizable configuration for HTTP requests.
      */
     httpOptions?: HttpOptions;
+    /**
+     * Optional abort signal which can be used to cancel the request.
+     */
+    abortSignal?: AbortSignal;
 }
 
 /** A wrapper class for the http response. */
@@ -2070,6 +2219,13 @@ export declare enum Language {
 export declare interface ListCachedContentsConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     pageSize?: number;
     pageToken?: string;
 }
@@ -2092,6 +2248,13 @@ export declare class ListCachedContentsResponse {
 export declare interface ListFilesConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     pageSize?: number;
     pageToken?: string;
 }
@@ -2128,17 +2291,20 @@ export declare class Live {
      @experimental
 
      @remarks
-     If using the Gemini API, Live is currently only supported behind API
-     version `v1alpha`. Ensure that the API version is set to `v1alpha` when
-     initializing the SDK if relying on the Gemini API.
 
      @param params - The parameters for establishing a connection to the model.
      @return A live session.
 
      @example
      ```ts
+     let model: string;
+     if (GOOGLE_GENAI_USE_VERTEXAI) {
+     model = 'gemini-2.0-flash-live-preview-04-09';
+     } else {
+     model = 'gemini-2.0-flash-live-001';
+     }
      const session = await ai.live.connect({
-     model: 'gemini-2.0-flash-exp',
+     model: model,
      config: {
      responseModalities: [Modality.AUDIO],
      },
@@ -2233,6 +2399,22 @@ export declare interface LiveClientMessage {
 export declare interface LiveClientRealtimeInput {
     /** Inlined bytes data for media input. */
     mediaChunks?: Blob_2[];
+    /** The realtime audio input stream. */
+    audio?: Blob_2;
+    /**
+     Indicates that the audio stream has ended, e.g. because the microphone was
+     turned off.
+
+     This should only be sent when automatic activity detection is enabled
+     (which is the default).
+
+     The client can reopen the stream by sending an audio message.
+     */
+    audioStreamEnd?: boolean;
+    /** The realtime video input stream. */
+    video?: Blob_2;
+    /** The realtime text input stream. */
+    text?: string;
     /** Marks the start of user activity. */
     activityStart?: ActivityStart;
     /** Marks the end of user activity. */
@@ -2253,7 +2435,7 @@ export declare interface LiveClientSetup {
     /** The user provided system instructions for the model.
      Note: only text should be used in parts and content in each part will be
      in a separate paragraph. */
-    systemInstruction?: Content;
+    systemInstruction?: ContentUnion;
     /**  A list of `Tools` the model may use to generate the next response.
 
      A `Tool` is a piece of code that enables the system to interact with
@@ -2270,6 +2452,13 @@ export declare interface LiveClientSetup {
 
      If included, server will compress context window to fit into given length. */
     contextWindowCompression?: ContextWindowCompressionConfig;
+    /** The transcription of the input aligns with the input audio language.
+     */
+    inputAudioTranscription?: AudioTranscriptionConfig;
+    /** The transcription of the output aligns with the language code
+     specified for the output audio.
+     */
+    outputAudioTranscription?: AudioTranscriptionConfig;
 }
 
 /** Client generated response to a `ToolCall` received from the server.
@@ -2295,13 +2484,42 @@ export declare interface LiveConnectConfig {
      modalities that the model can return. Defaults to AUDIO if not specified.
      */
     responseModalities?: Modality[];
+    /** Value that controls the degree of randomness in token selection.
+     Lower temperatures are good for prompts that require a less open-ended or
+     creative response, while higher temperatures can lead to more diverse or
+     creative results.
+     */
+    temperature?: number;
+    /** Tokens are selected from the most to least probable until the sum
+     of their probabilities equals this value. Use a lower value for less
+     random responses and a higher value for more random responses.
+     */
+    topP?: number;
+    /** For each token selection step, the ``top_k`` tokens with the
+     highest probabilities are sampled. Then tokens are further filtered based
+     on ``top_p`` with the final token selected using temperature sampling. Use
+     a lower number for less random responses and a higher number for more
+     random responses.
+     */
+    topK?: number;
+    /** Maximum number of tokens that can be generated in the response.
+     */
+    maxOutputTokens?: number;
+    /** If specified, the media resolution specified will be used.
+     */
+    mediaResolution?: MediaResolution;
+    /** When ``seed`` is fixed to a specific number, the model makes a best
+     effort to provide the same response for repeated requests. By default, a
+     random number is used.
+     */
+    seed?: number;
     /** The speech generation configuration.
      */
     speechConfig?: SpeechConfig;
     /** The user provided system instructions for the model.
      Note: only text should be used in parts and content in each part will be
      in a separate paragraph. */
-    systemInstruction?: Content;
+    systemInstruction?: ContentUnion;
     /** A list of `Tools` the model may use to generate the next response.
 
      A `Tool` is a piece of code that enables the system to interact with
@@ -2312,6 +2530,13 @@ export declare interface LiveConnectConfig {
 
      If included the server will send SessionResumptionUpdate messages. */
     sessionResumption?: SessionResumptionConfig;
+    /** The transcription of the input aligns with the input audio language.
+     */
+    inputAudioTranscription?: AudioTranscriptionConfig;
+    /** The transcription of the output aligns with the language code
+     specified for the output audio.
+     */
+    outputAudioTranscription?: AudioTranscriptionConfig;
     /** Configures the realtime input behavior in BidiGenerateContent. */
     realtimeInputConfig?: RealtimeInputConfig;
     /** Configures context window compression mechanism.
@@ -2345,7 +2570,23 @@ export declare interface LiveSendClientContentParameters {
 /** Parameters for sending realtime input to the live API. */
 export declare interface LiveSendRealtimeInputParameters {
     /** Realtime input to send to the session. */
-    media: Blob_2;
+    media?: BlobImageUnion;
+    /** The realtime audio input stream. */
+    audio?: Blob_2;
+    /**
+     Indicates that the audio stream has ended, e.g. because the microphone was
+     turned off.
+
+     This should only be sent when automatic activity detection is enabled
+     (which is the default).
+
+     The client can reopen the stream by sending an audio message.
+     */
+    audioStreamEnd?: boolean;
+    /** The realtime video input stream. */
+    video?: BlobImageUnion;
+    /** The realtime text input stream. */
+    text?: string;
     /** Marks the start of user activity. */
     activityStart?: ActivityStart;
     /** Marks the end of user activity. */
@@ -2379,6 +2620,15 @@ export declare interface LiveServerContent {
      has finished generating all content. This is a signal to the client
      that it can stop sending messages. */
     generationComplete?: boolean;
+    /** Input transcription. The transcription is independent to the model
+     turn which means it doesn’t imply any ordering between transcription and
+     model turn. */
+    inputTranscription?: Transcription;
+    /** Output transcription. The transcription is independent to the model
+     turn which means it doesn’t imply any ordering between transcription and
+     model turn.
+     */
+    outputTranscription?: Transcription;
 }
 
 /** Server will not be able to service client soon. */
@@ -2799,6 +3049,12 @@ export declare class Models extends BaseModule {
     generateVideos(params: types.GenerateVideosParameters): Promise<types.GenerateVideosOperation>;
 }
 
+/** Config for model selection. */
+export declare interface ModelSelectionConfig {
+    /** Options for feature selection preference. */
+    featureSelectionPreference?: FeatureSelectionPreference;
+}
+
 /** Parameters for the get method of the operations module. */
 export declare interface OperationGetParameters {
     /** The operation to be retrieved. */
@@ -3006,6 +3262,54 @@ export declare interface PrebuiltVoiceConfig {
     voiceName?: string;
 }
 
+/** Specifies the context retrieval config. */
+export declare interface RagRetrievalConfig {
+    /** Optional. Config for filters. */
+    filter?: RagRetrievalConfigFilter;
+    /** Optional. Config for Hybrid Search. */
+    hybridSearch?: RagRetrievalConfigHybridSearch;
+    /** Optional. Config for ranking and reranking. */
+    ranking?: RagRetrievalConfigRanking;
+    /** Optional. The number of contexts to retrieve. */
+    topK?: number;
+}
+
+/** Config for filters. */
+export declare interface RagRetrievalConfigFilter {
+    /** Optional. String for metadata filtering. */
+    metadataFilter?: string;
+    /** Optional. Only returns contexts with vector distance smaller than the threshold. */
+    vectorDistanceThreshold?: number;
+    /** Optional. Only returns contexts with vector similarity larger than the threshold. */
+    vectorSimilarityThreshold?: number;
+}
+
+/** Config for Hybrid Search. */
+export declare interface RagRetrievalConfigHybridSearch {
+    /** Optional. Alpha value controls the weight between dense and sparse vector search results. The range is [0, 1], while 0 means sparse vector search only and 1 means dense vector search only. The default value is 0.5 which balances sparse and dense vector search equally. */
+    alpha?: number;
+}
+
+/** Config for ranking and reranking. */
+export declare interface RagRetrievalConfigRanking {
+    /** Optional. Config for LlmRanker. */
+    llmRanker?: RagRetrievalConfigRankingLlmRanker;
+    /** Optional. Config for Rank Service. */
+    rankService?: RagRetrievalConfigRankingRankService;
+}
+
+/** Config for LlmRanker. */
+export declare interface RagRetrievalConfigRankingLlmRanker {
+    /** Optional. The model name used for ranking. Format: `gemini-1.5-pro` */
+    modelName?: string;
+}
+
+/** Config for Rank Service. */
+export declare interface RagRetrievalConfigRankingRankService {
+    /** Optional. The model name of the rank service. Format: `semantic-ranker-512@latest` */
+    modelName?: string;
+}
+
 /** A raw reference image.
 
  A raw reference image represents the base image to edit, provided by the user.
@@ -3231,7 +3535,6 @@ export declare class Session {
     private readonly apiClient;
     constructor(conn: WebSocket_2, apiClient: ApiClient);
     private tLiveClientContent;
-    private tLiveClientRealtimeInput;
     private tLiveClienttToolResponse;
     /**
      Send a message over the established connection.
@@ -3328,8 +3631,14 @@ export declare class Session {
 
      @example
      ```ts
+     let model: string;
+     if (GOOGLE_GENAI_USE_VERTEXAI) {
+     model = 'gemini-2.0-flash-live-preview-04-09';
+     } else {
+     model = 'gemini-2.0-flash-live-001';
+     }
      const session = await ai.live.connect({
-     model: 'gemini-2.0-flash-exp',
+     model: model,
      config: {
      responseModalities: [Modality.AUDIO],
      }
@@ -3355,6 +3664,28 @@ export declare interface SessionResumptionConfig {
     transparent?: boolean;
 }
 
+/**
+ * Overrides the base URLs for the Gemini API and Vertex AI API.
+ *
+ * @remarks This function should be called before initializing the SDK. If the
+ * base URLs are set after initializing the SDK, the base URLs will not be
+ * updated. Base URLs provided in the HttpOptions will also take precedence over
+ * URLs set here.
+ *
+ * @example
+ * ```ts
+ * import {GoogleGenAI, setDefaultBaseUrls} from '@google/genai';
+ * // Override the base URL for the Gemini API.
+ * setDefaultBaseUrls({geminiUrl:'https://gemini.google.com'});
+ *
+ * // Override the base URL for the Vertex AI API.
+ * setDefaultBaseUrls({vertexUrl: 'https://vertexai.googleapis.com'});
+ *
+ * const ai = new GoogleGenAI({apiKey: 'GEMINI_API_KEY'});
+ * ```
+ */
+export declare function setDefaultBaseUrls(baseUrlParams: BaseUrlParameters): void;
+
 /** Context window will be truncated by keeping only suffix of it.
 
  Context window will always be cut at start of USER role turn. System
@@ -3372,6 +3703,10 @@ export declare interface SpeechConfig {
     /** The configuration for the speaker to use.
      */
     voiceConfig?: VoiceConfig;
+    /** Language code (ISO 639. e.g. en-US) for the speech synthesization.
+     Only available for Live API.
+     */
+    languageCode?: string;
 }
 
 export declare type SpeechConfigUnion = SpeechConfig | string;
@@ -3526,6 +3861,16 @@ export declare enum TrafficType {
     PROVISIONED_THROUGHPUT = "PROVISIONED_THROUGHPUT"
 }
 
+/** Audio transcription in Server Conent. */
+export declare interface Transcription {
+    /** Transcription text.
+     */
+    text?: string;
+    /** The bool indicates the end of the transcription.
+     */
+    finished?: boolean;
+}
+
 /** A tuned machine learning model. */
 export declare interface TunedModelInfo {
     /** ID of the base model that you want to tune. */
@@ -3579,6 +3924,7 @@ declare namespace types {
         TrafficType,
         Modality,
         MediaResolution,
+        FeatureSelectionPreference,
         DynamicRetrievalConfigMode,
         FunctionCallingConfigMode,
         SafetyFilterLevel,
@@ -3605,6 +3951,7 @@ declare namespace types {
         Content,
         HttpOptions,
         Schema,
+        ModelSelectionConfig,
         SafetySetting,
         FunctionDeclaration,
         GoogleSearch,
@@ -3612,6 +3959,12 @@ declare namespace types {
         GoogleSearchRetrieval,
         VertexAISearch,
         VertexRagStoreRagResource,
+        RagRetrievalConfigFilter,
+        RagRetrievalConfigHybridSearch,
+        RagRetrievalConfigRankingLlmRanker,
+        RagRetrievalConfigRankingRankService,
+        RagRetrievalConfigRanking,
+        RagRetrievalConfig,
         VertexRagStore,
         Retrieval,
         ToolCodeExecution,
@@ -3732,6 +4085,7 @@ declare namespace types {
         SubjectReferenceConfig,
         SubjectReferenceImage,
         LiveServerSetupComplete,
+        Transcription,
         LiveServerContent,
         LiveServerToolCall,
         LiveServerToolCallCancellation,
@@ -3744,6 +4098,7 @@ declare namespace types {
         SessionResumptionConfig,
         SlidingWindow,
         ContextWindowCompressionConfig,
+        AudioTranscriptionConfig,
         LiveClientSetup,
         LiveClientContent,
         ActivityStart,
@@ -3751,7 +4106,6 @@ declare namespace types {
         LiveClientRealtimeInput,
         LiveClientToolResponse,
         LiveClientMessage,
-        AudioTranscriptionConfig,
         LiveConnectConfig,
         LiveConnectParameters,
         CreateChatParameters,
@@ -3760,6 +4114,7 @@ declare namespace types {
         LiveSendRealtimeInputParameters,
         LiveSendToolResponseParameters,
         OperationGetParameters,
+        BlobImageUnion,
         PartUnion,
         PartListUnion,
         ContentUnion,
@@ -3774,6 +4129,13 @@ declare namespace types {
 export declare interface UpdateCachedContentConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     /** The TTL for this resource. The expiration time is computed: now + TTL. It is a duration string, with up to nine fractional digits, terminated by 's'. Example: "3.5s". */
     ttl?: string;
     /** Timestamp of when this resource is considered expired. Uses RFC 3339 format, Example: 2014-10-02T15:01:23Z. */
@@ -3816,6 +4178,13 @@ declare interface Uploader {
 export declare interface UploadFileConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     /** The name of the file in the destination (e.g., 'files/sample-image'. If not provided one will be generated. */
     name?: string;
     /** mime_type: The MIME type of the file. If not provided, it will be inferred from the file extension. */
@@ -3841,6 +4210,13 @@ export declare interface UploadFileParameters {
 export declare interface UpscaleImageConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
     /** Whether to include a reason for filtered-out images in the
      response. */
     includeRaiReason?: boolean;
@@ -3904,6 +4280,8 @@ export declare interface VertexRagStore {
     ragCorpora?: string[];
     /** Optional. The representation of the rag source. It can be used to specify corpus only or ragfiles. Currently only support one corpus or multiple files from one corpus. In the future we may open up multiple corpora support. */
     ragResources?: VertexRagStoreRagResource[];
+    /** Optional. The retrieval config for the Rag query. */
+    ragRetrievalConfig?: RagRetrievalConfig;
     /** Optional. Number of top k results to return from the selected corpora. */
     similarityTopK?: number;
     /** Optional. Only return results with vector distance smaller than the threshold. */