@google/genai 1.50.1 → 1.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/web/web.d.ts CHANGED
@@ -480,7 +480,7 @@ declare interface AudioContent {
480
480
  /**
481
481
  * The sample rate of the audio.
482
482
  */
483
- rate?: number;
483
+ sample_rate?: number;
484
484
  /**
485
485
  * The URI of the audio.
486
486
  */
@@ -655,7 +655,7 @@ declare interface BaseCreateAgentInteractionParams {
655
655
  /**
656
656
  * Body param: The name of the `Agent` used for generating the interaction.
657
657
  */
658
- agent: (string & {}) | 'deep-research-pro-preview-12-2025';
658
+ agent: 'deep-research-pro-preview-12-2025' | 'deep-research-preview-04-2026' | 'deep-research-max-preview-04-2026' | (string & {});
659
659
  /**
660
660
  * Body param: The input for the interaction.
661
661
  */
@@ -954,7 +954,7 @@ declare class BaseWebhooks extends APIResource {
954
954
  /**
955
955
  * Updates an existing Webhook.
956
956
  */
957
- update(id: string, params: WebhookUpdateParams, options?: RequestOptions): APIPromise<Webhook>;
957
+ update(id: string, params?: WebhookUpdateParams | null | undefined, options?: RequestOptions): APIPromise<Webhook>;
958
958
  /**
959
959
  * Lists all Webhooks.
960
960
  */
@@ -1107,7 +1107,7 @@ export declare interface BatchJob {
1107
1107
  createTime?: string;
1108
1108
  /** Output only. Time when the Job for the first time entered the `JOB_STATE_RUNNING` state. */
1109
1109
  startTime?: string;
1110
- /** The time when the BatchJob was completed. This field is for Vertex AI only.
1110
+ /** The time when the BatchJob was completed. This field is for Gemini Enterprise Agent Platform only.
1111
1111
  */
1112
1112
  endTime?: string;
1113
1113
  /** The time when the BatchJob was last updated.
@@ -1116,21 +1116,24 @@ export declare interface BatchJob {
1116
1116
  /** The name of the model that produces the predictions via the BatchJob.
1117
1117
  */
1118
1118
  model?: string;
1119
- /** Configuration for the input data. This field is for Vertex AI only.
1119
+ /** Configuration for the input data. This field is for Gemini Enterprise Agent Platform only.
1120
1120
  */
1121
1121
  src?: BatchJobSource;
1122
1122
  /** Configuration for the output data.
1123
1123
  */
1124
1124
  dest?: BatchJobDestination;
1125
- /** Statistics on completed and failed prediction instances. This field is for Vertex AI only.
1125
+ /** Statistics on completed and failed prediction instances. This field is for Gemini Enterprise Agent Platform only.
1126
1126
  */
1127
1127
  completionStats?: CompletionStats;
1128
+ /** Information further describing the output of this job. Output only.
1129
+ */
1130
+ outputInfo?: BatchJobOutputInfo;
1128
1131
  }
1129
1132
 
1130
1133
  /** Config for `des` parameter. */
1131
1134
  export declare interface BatchJobDestination {
1132
1135
  /** Storage format of the output files. Must be one of:
1133
- 'jsonl', 'bigquery'.
1136
+ 'jsonl', 'bigquery', 'vertex-dataset'.
1134
1137
  */
1135
1138
  format?: string;
1136
1139
  /** The Google Cloud Storage URI to the output file.
@@ -1156,14 +1159,27 @@ export declare interface BatchJobDestination {
1156
1159
  the input requests.
1157
1160
  */
1158
1161
  inlinedEmbedContentResponses?: InlinedEmbedContentResponse[];
1162
+ /** This field is experimental and may change in future versions. The Vertex AI dataset destination.
1163
+ */
1164
+ vertexDataset?: VertexMultimodalDatasetDestination;
1159
1165
  }
1160
1166
 
1161
1167
  export declare type BatchJobDestinationUnion = BatchJobDestination | string;
1162
1168
 
1169
+ /** Represents the `output_info` field in batch jobs. */
1170
+ export declare interface BatchJobOutputInfo {
1171
+ /** This field is experimental and may change in future versions. The Vertex AI dataset name containing the output data. */
1172
+ vertexMultimodalDatasetName?: string;
1173
+ /** The full path of the Cloud Storage directory created, into which the prediction output is written. */
1174
+ gcsOutputDirectory?: string;
1175
+ /** The name of the BigQuery table created, in `predictions_<timestamp>` format, into which the prediction output is written. */
1176
+ bigqueryOutputTable?: string;
1177
+ }
1178
+
1163
1179
  /** Config for `src` parameter. */
1164
1180
  export declare interface BatchJobSource {
1165
1181
  /** Storage format of the input files. Must be one of:
1166
- 'jsonl', 'bigquery'.
1182
+ 'jsonl', 'bigquery', 'vertex-dataset'.
1167
1183
  */
1168
1184
  format?: string;
1169
1185
  /** The Google Cloud Storage URIs to input files.
@@ -1179,6 +1195,9 @@ export declare interface BatchJobSource {
1179
1195
  /** The Gemini Developer API's inlined input data to run batch job.
1180
1196
  */
1181
1197
  inlinedRequests?: InlinedRequest[];
1198
+ /** This field is experimental and may change in future versions. The Vertex AI dataset resource name to use as input. Must be of type multimodal.
1199
+ */
1200
+ vertexDatasetName?: string;
1182
1201
  }
1183
1202
 
1184
1203
  export declare type BatchJobSourceUnion = BatchJobSource | InlinedRequest[] | string;
@@ -1322,7 +1341,7 @@ export declare class Caches extends BaseModule {
1322
1341
  * @remarks
1323
1342
  * Context caching is only supported for specific models. See [Gemini
1324
1343
  * Developer API reference](https://ai.google.dev/gemini-api/docs/caching?lang=node/context-cac)
1325
- * and [Vertex AI reference](https://cloud.google.com/vertex-ai/generative-ai/docs/context-cache/context-cache-overview#supported_models)
1344
+ * and [Gemini Enterprise Agent Platform reference](https://cloud.google.com/vertex-ai/generative-ai/docs/context-cache/context-cache-overview#supported_models)
1326
1345
  * for more information.
1327
1346
  *
1328
1347
  * @param params - The parameters for the create request.
@@ -1925,9 +1944,13 @@ declare namespace ContentDelta {
1925
1944
  data?: string;
1926
1945
  mime_type?: 'audio/wav' | 'audio/mp3' | 'audio/aiff' | 'audio/aac' | 'audio/ogg' | 'audio/flac' | 'audio/mpeg' | 'audio/m4a' | 'audio/l16' | 'audio/opus' | 'audio/alaw' | 'audio/mulaw';
1927
1946
  /**
1928
- * The sample rate of the audio.
1947
+ * @deprecated Deprecated. Use sample_rate instead. The value is ignored.
1929
1948
  */
1930
1949
  rate?: number;
1950
+ /**
1951
+ * The sample rate of the audio.
1952
+ */
1953
+ sample_rate?: number;
1931
1954
  uri?: string;
1932
1955
  }
1933
1956
  interface Document {
@@ -2134,24 +2157,13 @@ declare namespace ContentDelta {
2134
2157
  * Required. ID to match the ID from the function call block.
2135
2158
  */
2136
2159
  call_id: string;
2137
- result: Array<FileSearchResult.Result>;
2160
+ result: Array<unknown>;
2138
2161
  type: 'file_search_result';
2139
2162
  /**
2140
2163
  * A signature hash for backend validation.
2141
2164
  */
2142
2165
  signature?: string;
2143
2166
  }
2144
- namespace FileSearchResult {
2145
- /**
2146
- * The result of the File Search.
2147
- */
2148
- interface Result {
2149
- /**
2150
- * User provided metadata about the FileSearchResult.
2151
- */
2152
- custom_metadata?: Array<unknown>;
2153
- }
2154
- }
2155
2167
  interface GoogleMapsResult {
2156
2168
  /**
2157
2169
  * Required. ID to match the ID from the function call block.
@@ -2181,7 +2193,7 @@ export declare interface ContentEmbedding {
2181
2193
  /** A list of floats representing an embedding.
2182
2194
  */
2183
2195
  values?: number[];
2184
- /** Vertex API only. Statistics of the input text associated with this
2196
+ /** Gemini Enterprise Agent Platform only. Statistics of the input text associated with this
2185
2197
  embedding.
2186
2198
  */
2187
2199
  statistics?: ContentEmbeddingStatistics;
@@ -2189,11 +2201,11 @@ export declare interface ContentEmbedding {
2189
2201
 
2190
2202
  /** Statistics of the input text associated with the result of content embedding. */
2191
2203
  export declare interface ContentEmbeddingStatistics {
2192
- /** Vertex API only. If the input text was truncated due to having
2204
+ /** Gemini Enterprise Agent Platform only. If the input text was truncated due to having
2193
2205
  a length longer than the allowed maximum input.
2194
2206
  */
2195
2207
  truncated?: boolean;
2196
- /** Vertex API only. Number of tokens of the input text.
2208
+ /** Gemini Enterprise Agent Platform only. Number of tokens of the input text.
2197
2209
  */
2198
2210
  tokenCount?: number;
2199
2211
  }
@@ -2583,6 +2595,10 @@ export declare interface CreateFileSearchStoreConfig {
2583
2595
  /** The human-readable display name for the file search store.
2584
2596
  */
2585
2597
  displayName?: string;
2598
+ /** The embedding model to use for the FileSearchStore.
2599
+ Format: `models/{model}`. If not specified, the default embedding model will be used.
2600
+ */
2601
+ embeddingModel?: string;
2586
2602
  }
2587
2603
 
2588
2604
  /** Config for file_search_stores.create parameters. */
@@ -2687,9 +2703,9 @@ export declare interface CreateTuningJobConfig {
2687
2703
  adapterSize?: AdapterSize;
2688
2704
  /** Tuning mode for tuning. */
2689
2705
  tuningMode?: TuningMode;
2690
- /** Custom base model for tuning. This is only supported for OSS models in Vertex. */
2706
+ /** Custom base model for tuning. This is only supported for OSS models in Gemini Enterprise Agent Platform. */
2691
2707
  customBaseModel?: string;
2692
- /** The batch size hyperparameter for tuning. This is only supported for OSS models in Vertex. */
2708
+ /** The batch size hyperparameter for tuning. This is only supported for OSS models in Gemini Enterprise Agent Platform. */
2693
2709
  batchSize?: number;
2694
2710
  /** The learning rate for tuning. OSS models only. Mutually exclusive with learning_rate_multiplier. */
2695
2711
  learningRate?: number;
@@ -3027,7 +3043,8 @@ export declare interface DistillationHyperParameters {
3027
3043
  /** Optional. Multiplier for adjusting the default learning rate. */
3028
3044
  learningRateMultiplier?: number;
3029
3045
  /** The batch size hyperparameter for tuning.
3030
- This is only supported for OSS models in Vertex. */
3046
+ This is only supported for OSS models in Gemini Enterprise Agent Platform.
3047
+ */
3031
3048
  batchSize?: number;
3032
3049
  /** The learning rate for tuning. OSS models only. */
3033
3050
  learningRate?: number;
@@ -3198,6 +3215,19 @@ export declare interface DownloadFileParameters {
3198
3215
  config?: DownloadFileConfig;
3199
3216
  }
3200
3217
 
3218
+ /** Used to override the default configuration. */
3219
+ export declare interface DownloadMediaConfig {
3220
+ /** Used to override HTTP request options. */
3221
+ httpOptions?: HttpOptions;
3222
+ /** Abort signal which can be used to cancel the request.
3223
+
3224
+ NOTE: AbortSignal is a client-only operation. Using it to cancel an
3225
+ operation will not cancel the request in the service. You will still
3226
+ be charged usage for any applicable operations.
3227
+ */
3228
+ abortSignal?: AbortSignal;
3229
+ }
3230
+
3201
3231
  /**
3202
3232
  * Configuration for dynamic agents.
3203
3233
  */
@@ -3347,27 +3377,27 @@ export declare interface EmbedContentConfig {
3347
3377
  using the earlier model (`models/embedding-001`).
3348
3378
  */
3349
3379
  outputDimensionality?: number;
3350
- /** Vertex API only. The MIME type of the input.
3380
+ /** Gemini Enterprise Agent Platform only. The MIME type of the input.
3351
3381
  */
3352
3382
  mimeType?: string;
3353
- /** Vertex API only. Whether to silently truncate inputs longer than
3383
+ /** Gemini Enterprise Agent Platform only. Whether to silently truncate inputs longer than
3354
3384
  the max sequence length. If this option is set to false, oversized inputs
3355
3385
  will lead to an INVALID_ARGUMENT error, similar to other text APIs.
3356
3386
  */
3357
3387
  autoTruncate?: boolean;
3358
- /** Vertex API only. Whether to enable OCR for document content.
3388
+ /** Gemini Enterprise Agent Platform only. Whether to enable OCR for document content.
3359
3389
  Only applicable to Gemini Embedding 2 models.
3360
3390
  */
3361
3391
  documentOcr?: boolean;
3362
- /** Vertex API only. Whether to extract audio from video content.
3392
+ /** Gemini Enterprise Agent Platform only. Whether to extract audio from video content.
3363
3393
  Only applicable to Gemini Embedding 2 models.
3364
3394
  */
3365
3395
  audioTrackExtraction?: boolean;
3366
3396
  }
3367
3397
 
3368
- /** Request-level metadata for the Vertex Embed Content API. */
3398
+ /** Request-level metadata for the Gemini Enterprise Agent Platform Embed Content API. */
3369
3399
  export declare interface EmbedContentMetadata {
3370
- /** Vertex API only. The total number of billable characters included
3400
+ /** Gemini Enterprise Agent Platform only. The total number of billable characters included
3371
3401
  in the request.
3372
3402
  */
3373
3403
  billableCharacterCount?: number;
@@ -3397,7 +3427,7 @@ export declare interface EmbedContentParametersPrivate {
3397
3427
  /** The single content to embed. Only the `parts.text` fields will be counted.
3398
3428
  */
3399
3429
  content?: ContentUnion;
3400
- /** The Vertex embedding API to use.
3430
+ /** The Gemini Enterprise Agent Platform embedding API to use.
3401
3431
  */
3402
3432
  embeddingApiType?: EmbeddingApiType;
3403
3433
  /** Configuration that contains optional parameters.
@@ -3413,12 +3443,12 @@ export declare class EmbedContentResponse {
3413
3443
  the batch request.
3414
3444
  */
3415
3445
  embeddings?: ContentEmbedding[];
3416
- /** Vertex API only. Metadata about the request.
3446
+ /** Gemini Enterprise Agent Platform only. Metadata about the request.
3417
3447
  */
3418
3448
  metadata?: EmbedContentMetadata;
3419
3449
  }
3420
3450
 
3421
- /** Enum representing the Vertex embedding API to use. */
3451
+ /** Enum representing the Gemini Enterprise Agent Platform embedding API to use. */
3422
3452
  export declare enum EmbeddingApiType {
3423
3453
  /**
3424
3454
  * predict API endpoint (default)
@@ -3701,6 +3731,12 @@ export { File_2 as File }
3701
3731
  */
3702
3732
  declare interface FileCitation {
3703
3733
  type: 'file_citation';
3734
+ /**
3735
+ * User provided metadata about the retrieved context.
3736
+ */
3737
+ custom_metadata?: {
3738
+ [key: string]: unknown;
3739
+ };
3704
3740
  /**
3705
3741
  * The URI of the file.
3706
3742
  */
@@ -3713,6 +3749,14 @@ declare interface FileCitation {
3713
3749
  * The name of the file.
3714
3750
  */
3715
3751
  file_name?: string;
3752
+ /**
3753
+ * Media ID in-case of image citations, if applicable.
3754
+ */
3755
+ media_id?: string;
3756
+ /**
3757
+ * Page number of the cited document, if applicable.
3758
+ */
3759
+ page_number?: number;
3716
3760
  /**
3717
3761
  * Source attributed for a portion of the text.
3718
3762
  */
@@ -3755,7 +3799,7 @@ export declare class Files extends BaseModule {
3755
3799
  list: (params?: types.ListFilesParameters) => Promise<Pager<types.File>>;
3756
3800
  /**
3757
3801
  * Uploads a file asynchronously to the Gemini API.
3758
- * This method is not available in Vertex AI.
3802
+ * This method is not available in Gemini Enterprise Agent Platform (previously known as Vertex AI).
3759
3803
  * Supported upload sources:
3760
3804
  * - Node.js: File path (string) or Blob object.
3761
3805
  * - Browser: Blob object (e.g., File).
@@ -3781,7 +3825,7 @@ export declare class Files extends BaseModule {
3781
3825
  * @see {@link types.UploadFileParameters#config} for the optional
3782
3826
  * config in the parameters.
3783
3827
  * @return A promise that resolves to a `types.File` object.
3784
- * @throws An error if called on a Vertex AI client.
3828
+ * @throws An error if called on a Gemini Enterprise Agent Platform (previously known as Vertex AI) client.
3785
3829
  * @throws An error if the `mimeType` is not provided and can not be inferred,
3786
3830
  * the `mimeType` can be provided in the `params.config` parameter.
3787
3831
  * @throws An error occurs if a suitable upload location cannot be established.
@@ -3888,29 +3932,17 @@ declare interface FileSearchResultContent {
3888
3932
  * Required. ID to match the ID from the function call block.
3889
3933
  */
3890
3934
  call_id: string;
3935
+ type: 'file_search_result';
3891
3936
  /**
3892
- * Required. The results of the File Search.
3937
+ * Optional. The results of the File Search.
3893
3938
  */
3894
- result: Array<FileSearchResultContent.Result>;
3895
- type: 'file_search_result';
3939
+ result?: Array<unknown>;
3896
3940
  /**
3897
3941
  * A signature hash for backend validation.
3898
3942
  */
3899
3943
  signature?: string;
3900
3944
  }
3901
3945
 
3902
- declare namespace FileSearchResultContent {
3903
- /**
3904
- * The result of the File Search.
3905
- */
3906
- interface Result {
3907
- /**
3908
- * User provided metadata about the FileSearchResult.
3909
- */
3910
- custom_metadata?: Array<unknown>;
3911
- }
3912
- }
3913
-
3914
3946
  /** A collection of Documents. */
3915
3947
  export declare interface FileSearchStore {
3916
3948
  /** The resource name of the FileSearchStore. Example: `fileSearchStores/my-file-search-store-123` */
@@ -3930,6 +3962,8 @@ export declare interface FileSearchStore {
3930
3962
  /** The size of raw bytes ingested into the FileSearchStore. This is the
3931
3963
  total size of all the documents in the FileSearchStore. */
3932
3964
  sizeBytes?: string;
3965
+ /** The embedding model used by the FileSearchStore. */
3966
+ embeddingModel?: string;
3933
3967
  }
3934
3968
 
3935
3969
  declare class FileSearchStores extends BaseModule {
@@ -3953,7 +3987,7 @@ declare class FileSearchStores extends BaseModule {
3953
3987
  list: (params?: types.ListFileSearchStoresParameters) => Promise<Pager<types.FileSearchStore>>;
3954
3988
  /**
3955
3989
  * Uploads a file asynchronously to a given File Search Store.
3956
- * This method is not available in Vertex AI.
3990
+ * This method is not available in Gemini Enterprise Agent Platform (previously known as Vertex AI).
3957
3991
  * Supported upload sources:
3958
3992
  * - Node.js: File path (string) or Blob object.
3959
3993
  * - Browser: Blob object (e.g., File).
@@ -3972,7 +4006,7 @@ declare class FileSearchStores extends BaseModule {
3972
4006
  * @see {@link types.UploadToFileSearchStoreParameters#config} for the optional
3973
4007
  * config in the parameters.
3974
4008
  * @return A promise that resolves to a long running operation.
3975
- * @throws An error if called on a Vertex AI client.
4009
+ * @throws An error if called on a Gemini Enterprise Agent Platform (previously known as Vertex AI) client.
3976
4010
  * @throws An error if the `mimeType` is not provided and can not be inferred,
3977
4011
  * the `mimeType` can be provided in the `params.config` parameter.
3978
4012
  * @throws An error occurs if a suitable upload location cannot be established.
@@ -3988,6 +4022,15 @@ declare class FileSearchStores extends BaseModule {
3988
4022
  * ```
3989
4023
  */
3990
4024
  uploadToFileSearchStore(params: types.UploadToFileSearchStoreParameters): Promise<types.UploadToFileSearchStoreOperation>;
4025
+ /**
4026
+ * Downloads media using a Media ID or URI.
4027
+ * This method is only supported in the Gemini Developer client.
4028
+ *
4029
+ * @param uri - The URI or Media ID of the blob.
4030
+ * @param config - Optional configuration for the download.
4031
+ * @returns A promise that resolves to the blob data as a Uint8Array.
4032
+ */
4033
+ downloadMedia(uri: string, config?: types.DownloadMediaConfig): Promise<Uint8Array>;
3991
4034
  /**
3992
4035
  * Creates a File Search Store.
3993
4036
  *
@@ -4568,7 +4611,7 @@ export declare interface GenerateContentConfig {
4568
4611
  */
4569
4612
  imageConfig?: ImageConfig;
4570
4613
  /** Enables enhanced civic answers. It may not be available for all
4571
- models. This field is not supported in Vertex AI.
4614
+ models. This field is not supported in Gemini Enterprise Agent Platform.
4572
4615
  */
4573
4616
  enableEnhancedCivicAnswers?: boolean;
4574
4617
  /** Settings for prompt and response sanitization using the Model Armor
@@ -4949,6 +4992,8 @@ export declare interface GenerateVideosConfig {
4949
4992
  /** Webhook configuration for receiving notifications when the
4950
4993
  video generation operation completes. */
4951
4994
  webhookConfig?: WebhookConfig;
4995
+ /** Resize mode of the image input for video generation. */
4996
+ resizeMode?: ImageResizeMode;
4952
4997
  }
4953
4998
 
4954
4999
  /** A video generation operation. */
@@ -5381,8 +5426,23 @@ export declare interface GoogleGenAIOptions {
5381
5426
  * Optional. Determines whether to use the Vertex AI or the Gemini API.
5382
5427
  *
5383
5428
  * @remarks
5429
+ * When true, the {@link https://cloud.google.com/vertex-ai/docs/reference/rest | Gemini Enterprise Agent Platform API} will used.
5430
+ * When false, the {@link https://ai.google.dev/api | Gemini API} will be used.
5431
+ * When both enterprise and vertexai are set, and they have different values,
5432
+ * an Error will be thrown.
5433
+ *
5434
+ * If unset, default SDK behavior is to use the Gemini API service.
5435
+ */
5436
+ enterprise?: boolean;
5437
+ /**
5438
+ * Optional. Determines whether to use the Vertex AI (now Gemini Enterprise Agent Platform) or the Gemini API.
5439
+ * The `enterprise` flag is recommended instead.
5440
+ *
5441
+ * @remarks
5384
5442
  * When true, the {@link https://cloud.google.com/vertex-ai/docs/reference/rest | Vertex AI API} will used.
5385
5443
  * When false, the {@link https://ai.google.dev/api | Gemini API} will be used.
5444
+ * When both enterprise and vertexai are set, and they have different values,
5445
+ * an Error will be thrown.
5386
5446
  *
5387
5447
  * If unset, default SDK behavior is to use the Gemini API service.
5388
5448
  */
@@ -5785,6 +5845,10 @@ export declare interface GroundingChunkRetrievedContext {
5785
5845
  customMetadata?: GroundingChunkCustomMetadata[];
5786
5846
  /** Optional. Name of the `FileSearchStore` containing the document. Example: `fileSearchStores/123`. This field is not supported in Vertex AI. */
5787
5847
  fileSearchStore?: string;
5848
+ /** Optional. Page number of the retrieved context. This field is not supported in Vertex AI. */
5849
+ pageNumber?: number;
5850
+ /** Optional. Media ID. This field is not supported in Vertex AI. */
5851
+ mediaId?: string;
5788
5852
  }
5789
5853
 
5790
5854
  /** A list of string values. This data type is not supported in Vertex AI. */
@@ -6045,7 +6109,7 @@ export declare interface HttpOptions {
6045
6109
  timeout?: number;
6046
6110
  /** Extra parameters to add to the request body.
6047
6111
  The structure must match the backend API's request structure.
6048
- - VertexAI backend API docs: https://cloud.google.com/vertex-ai/docs/reference/rest
6112
+ - Gemini Enterprise Agent Platform backend API docs: https://cloud.google.com/vertex-ai/docs/reference/rest
6049
6113
  - GeminiAPI backend API docs: https://ai.google.dev/api/rest */
6050
6114
  extraBody?: Record<string, unknown>;
6051
6115
  /** HTTP retry options for the request. */
@@ -6233,6 +6297,20 @@ export declare enum ImagePromptLanguage {
6233
6297
  es = "es"
6234
6298
  }
6235
6299
 
6300
+ /** Resize mode for the image input for video generation. */
6301
+ export declare enum ImageResizeMode {
6302
+ /**
6303
+ * Crop the image to fit the correct aspect ratio (so we lose parts
6304
+ of the image in the process).
6305
+ */
6306
+ CROP = "CROP",
6307
+ /**
6308
+ * Pad the image to fit the correct aspect ratio (so we don't lose
6309
+ any parts of the image in the process).
6310
+ */
6311
+ PAD = "PAD"
6312
+ }
6313
+
6236
6314
  /** Image search for grounding and related configurations. */
6237
6315
  export declare interface ImageSearch {
6238
6316
  }
@@ -6356,7 +6434,7 @@ declare interface Interaction {
6356
6434
  /**
6357
6435
  * The name of the `Agent` used for generating the interaction.
6358
6436
  */
6359
- agent?: (string & {}) | 'deep-research-pro-preview-12-2025';
6437
+ agent?: 'deep-research-pro-preview-12-2025' | 'deep-research-preview-04-2026' | 'deep-research-max-preview-04-2026' | (string & {});
6360
6438
  /**
6361
6439
  * Configuration parameters for the agent interaction.
6362
6440
  */
@@ -8006,7 +8084,7 @@ export declare interface Model {
8006
8084
  * The model that will complete your prompt.\n\nSee
8007
8085
  * [models](https://ai.google.dev/gemini-api/docs/models) for additional details.
8008
8086
  */
8009
- declare type Model_2 = 'gemini-2.5-computer-use-preview-10-2025' | 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'lyria-3-clip-preview' | 'lyria-3-pro-preview' | (string & {});
8087
+ declare type Model_2 = 'gemini-2.5-computer-use-preview-10-2025' | 'gemini-2.5-flash' | 'gemini-2.5-flash-image' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-native-audio-preview-12-2025' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-preview-tts' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-flash-preview' | 'gemini-3-pro-image-preview' | 'gemini-3-pro-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-image-preview' | 'gemini-3.1-flash-lite-preview' | 'gemini-3.1-flash-tts-preview' | 'lyria-3-clip-preview' | 'lyria-3-pro-preview' | (string & {});
8010
8088
 
8011
8089
  /** Configuration for Model Armor. Model Armor is a Google Cloud service that provides safety and security filtering for prompts and responses. It helps protect your AI applications from risks such as harmful content, sensitive data leakage, and prompt injection attacks. This data type is not supported in Gemini API. */
8012
8090
  export declare interface ModelArmorConfig {
@@ -8044,7 +8122,7 @@ export declare class Models extends BaseModule {
8044
8122
  /**
8045
8123
  * Makes an API request to generate content with a given model.
8046
8124
  *
8047
- * For the `model` parameter, supported formats for Vertex AI API include:
8125
+ * For the `model` parameter, supported formats for Gemini Enterprise Agent Platform API include:
8048
8126
  * - The Gemini model ID, for example: 'gemini-2.0-flash'
8049
8127
  * - The full resource name starts with 'projects/', for example:
8050
8128
  * 'projects/my-project-id/locations/us-central1/publishers/google/models/gemini-2.0-flash'
@@ -8092,7 +8170,7 @@ export declare class Models extends BaseModule {
8092
8170
  * Makes an API request to generate content with a given model and yields the
8093
8171
  * response in chunks.
8094
8172
  *
8095
- * For the `model` parameter, supported formats for Vertex AI API include:
8173
+ * For the `model` parameter, supported formats for Gemini Enterprise Agent Platform API include:
8096
8174
  * - The Gemini model ID, for example: 'gemini-2.0-flash'
8097
8175
  * - The full resource name starts with 'projects/', for example:
8098
8176
  * 'projects/my-project-id/locations/us-central1/publishers/google/models/gemini-2.0-flash'
@@ -8183,7 +8261,7 @@ export declare class Models extends BaseModule {
8183
8261
  editImage: (params: types.EditImageParameters) => Promise<types.EditImageResponse>;
8184
8262
  /**
8185
8263
  * Upscales an image based on an image, upscale factor, and configuration.
8186
- * Only supported in Vertex AI currently.
8264
+ * Only supported in Gemini Enterprise Agent Platform currently.
8187
8265
  *
8188
8266
  * @param params - The parameters for upscaling an image.
8189
8267
  * @return The response from the API.
@@ -10776,7 +10854,7 @@ export declare interface TunedModelInfo {
10776
10854
  export declare interface TuningDataset {
10777
10855
  /** GCS URI of the file containing training dataset in JSONL format. */
10778
10856
  gcsUri?: string;
10779
- /** The resource name of the Vertex Multimodal Dataset that is used as training dataset. Example: 'projects/my-project-id-or-number/locations/my-location/datasets/my-dataset-id'. */
10857
+ /** The resource name of the Gemini Enterprise Agent Platform (previously known as Vertex AI) Multimodal Dataset that is used as training dataset. Example: 'projects/my-project-id-or-number/locations/my-location/datasets/my-dataset-id'. */
10780
10858
  vertexDatasetResource?: string;
10781
10859
  /** Inline examples with simple input/output text. */
10782
10860
  examples?: TuningExample[];
@@ -11027,7 +11105,7 @@ export declare enum TuningTask {
11027
11105
  export declare interface TuningValidationDataset {
11028
11106
  /** GCS URI of the file containing validation dataset in JSONL format. */
11029
11107
  gcsUri?: string;
11030
- /** The resource name of the Vertex Multimodal Dataset that is used as validation dataset. Example: 'projects/my-project-id-or-number/locations/my-location/datasets/my-dataset-id'. */
11108
+ /** The resource name of the Gemini Enterprise Agent Platform (previously known as Vertex AI) Multimodal Dataset that is used as validation dataset. Example: 'projects/my-project-id-or-number/locations/my-location/datasets/my-dataset-id'. */
11031
11109
  vertexDatasetResource?: string;
11032
11110
  }
11033
11111
 
@@ -11275,6 +11353,7 @@ declare namespace types {
11275
11353
  VideoGenerationReferenceType,
11276
11354
  VideoGenerationMaskMode,
11277
11355
  VideoCompressionQuality,
11356
+ ImageResizeMode,
11278
11357
  TuningMethod,
11279
11358
  FileState,
11280
11359
  FileSource,
@@ -11592,6 +11671,7 @@ declare namespace types {
11592
11671
  RegisterFilesResponse,
11593
11672
  InlinedRequest,
11594
11673
  BatchJobSource,
11674
+ VertexMultimodalDatasetDestination,
11595
11675
  JobError,
11596
11676
  InlinedResponse,
11597
11677
  SingleEmbedContentResponse,
@@ -11599,6 +11679,7 @@ declare namespace types {
11599
11679
  BatchJobDestination,
11600
11680
  CreateBatchJobConfig,
11601
11681
  CreateBatchJobParameters,
11682
+ BatchJobOutputInfo,
11602
11683
  CompletionStats,
11603
11684
  BatchJob,
11604
11685
  EmbedContentBatch,
@@ -11702,6 +11783,7 @@ declare namespace types {
11702
11783
  EmbedContentParameters,
11703
11784
  UploadToFileSearchStoreResponse,
11704
11785
  UploadToFileSearchStoreOperation,
11786
+ DownloadMediaConfig,
11705
11787
  BlobImageUnion,
11706
11788
  PartUnion,
11707
11789
  PartListUnion,
@@ -12135,6 +12217,10 @@ declare interface Usage {
12135
12217
  * A breakdown of cached token usage by modality.
12136
12218
  */
12137
12219
  cached_tokens_by_modality?: Array<Usage.CachedTokensByModality>;
12220
+ /**
12221
+ * Grounding tool count.
12222
+ */
12223
+ grounding_tool_count?: Array<Usage.GroundingToolCount>;
12138
12224
  /**
12139
12225
  * A breakdown of input token usage by modality.
12140
12226
  */
@@ -12188,6 +12274,19 @@ declare namespace Usage {
12188
12274
  */
12189
12275
  tokens?: number;
12190
12276
  }
12277
+ /**
12278
+ * The number of grounding tool counts.
12279
+ */
12280
+ interface GroundingToolCount {
12281
+ /**
12282
+ * The number of grounding tool counts.
12283
+ */
12284
+ count?: number;
12285
+ /**
12286
+ * The grounding tool type associated with the count.
12287
+ */
12288
+ type?: 'google_search' | 'google_maps' | 'retrieval';
12289
+ }
12191
12290
  /**
12192
12291
  * The token count for a single response modality.
12193
12292
  */
@@ -12316,6 +12415,16 @@ export declare interface VertexAISearchDataStoreSpec {
12316
12415
  filter?: string;
12317
12416
  }
12318
12417
 
12418
+ /** This class is experimental and may change in future versions.
12419
+
12420
+ The specification for an output Vertex AI multimodal dataset. */
12421
+ export declare interface VertexMultimodalDatasetDestination {
12422
+ /** The BigQuery destination for the multimodal dataset. */
12423
+ bigqueryDestination?: string;
12424
+ /** The display name of the multimodal dataset. */
12425
+ displayName?: string;
12426
+ }
12427
+
12319
12428
  /** Retrieve from Vertex RAG Store for grounding. This data type is not supported in Gemini API. */
12320
12429
  export declare interface VertexRagStore {
12321
12430
  /** Optional. Deprecated. Please use rag_resources instead. */
@@ -12504,26 +12613,28 @@ declare interface Webhook {
12504
12613
  * Required. The events that the webhook is subscribed to. Available events:
12505
12614
  *
12506
12615
  * - batch.succeeded
12507
- * - batch.cancelled
12508
12616
  * - batch.expired
12509
12617
  * - batch.failed
12510
12618
  * - interaction.requires_action
12511
12619
  * - interaction.completed
12512
12620
  * - interaction.failed
12513
- * - interaction.cancelled
12514
12621
  * - video.generated
12515
12622
  */
12516
- subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
12623
+ subscribed_events: Array<'batch.succeeded' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'video.generated' | (string & {})>;
12517
12624
  /**
12518
12625
  * Required. The URI to which webhook events will be sent.
12519
12626
  */
12520
12627
  uri: string;
12628
+ /**
12629
+ * Output only. The ID of the webhook.
12630
+ */
12631
+ id?: string;
12521
12632
  /**
12522
12633
  * Output only. The timestamp when the webhook was created.
12523
12634
  */
12524
12635
  create_time?: string;
12525
12636
  /**
12526
- * Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
12637
+ * Optional. The user-provided name of the webhook.
12527
12638
  */
12528
12639
  name?: string;
12529
12640
  /**
@@ -12535,7 +12646,7 @@ declare interface Webhook {
12535
12646
  */
12536
12647
  signing_secrets?: Array<SigningSecret>;
12537
12648
  /**
12538
- * The state of the webhook.
12649
+ * Output only. The state of the webhook.
12539
12650
  */
12540
12651
  state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
12541
12652
  /**
@@ -12586,33 +12697,22 @@ declare interface WebhookCreateParams {
12586
12697
  * events:
12587
12698
  *
12588
12699
  * - batch.succeeded
12589
- * - batch.cancelled
12590
12700
  * - batch.expired
12591
12701
  * - batch.failed
12592
12702
  * - interaction.requires_action
12593
12703
  * - interaction.completed
12594
12704
  * - interaction.failed
12595
- * - interaction.cancelled
12596
12705
  * - video.generated
12597
12706
  */
12598
- subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
12707
+ subscribed_events: Array<'batch.succeeded' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'video.generated' | (string & {})>;
12599
12708
  /**
12600
12709
  * Body param: Required. The URI to which webhook events will be sent.
12601
12710
  */
12602
12711
  uri: string;
12603
12712
  /**
12604
- * Query param: Optional. The webhook_id to use for the webhook. If not specified,
12605
- * the server will generate a unique ID.
12606
- */
12607
- webhook_id?: string;
12608
- /**
12609
- * Body param: Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
12713
+ * Body param: Optional. The user-provided name of the webhook.
12610
12714
  */
12611
12715
  name?: string;
12612
- /**
12613
- * Body param: The state of the webhook.
12614
- */
12615
- state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
12616
12716
  }
12617
12717
 
12618
12718
  declare interface WebhookDeleteParams {
@@ -12733,36 +12833,34 @@ declare interface WebhookUpdateParams {
12733
12833
  */
12734
12834
  api_version?: string;
12735
12835
  /**
12736
- * Body param: Required. The events that the webhook is subscribed to. Available
12836
+ * Query param: Optional. The list of fields to update.
12837
+ */
12838
+ update_mask?: string;
12839
+ /**
12840
+ * Body param: Optional. The user-provided name of the webhook.
12841
+ */
12842
+ name?: string;
12843
+ /**
12844
+ * Body param: Optional. The state of the webhook.
12845
+ */
12846
+ state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
12847
+ /**
12848
+ * Body param: Optional. The events that the webhook is subscribed to. Available
12737
12849
  * events:
12738
12850
  *
12739
12851
  * - batch.succeeded
12740
- * - batch.cancelled
12741
12852
  * - batch.expired
12742
12853
  * - batch.failed
12743
12854
  * - interaction.requires_action
12744
12855
  * - interaction.completed
12745
12856
  * - interaction.failed
12746
- * - interaction.cancelled
12747
12857
  * - video.generated
12748
12858
  */
12749
- subscribed_events: Array<'batch.succeeded' | 'batch.cancelled' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'interaction.cancelled' | 'video.generated' | (string & {})>;
12859
+ subscribed_events?: Array<'batch.succeeded' | 'batch.expired' | 'batch.failed' | 'interaction.requires_action' | 'interaction.completed' | 'interaction.failed' | 'video.generated' | (string & {})>;
12750
12860
  /**
12751
- * Body param: Required. The URI to which webhook events will be sent.
12861
+ * Body param: Optional. The URI to which webhook events will be sent.
12752
12862
  */
12753
- uri: string;
12754
- /**
12755
- * Query param: Optional. The list of fields to update.
12756
- */
12757
- update_mask?: string;
12758
- /**
12759
- * Body param: Identifier. The name of the webhook. Format: `webhooks/{webhook_id}`
12760
- */
12761
- name?: string;
12762
- /**
12763
- * Body param: The state of the webhook.
12764
- */
12765
- state?: 'enabled' | 'disabled' | 'disabled_due_to_failed_deliveries';
12863
+ uri?: string;
12766
12864
  }
12767
12865
 
12768
12866
  /** Standard web search for grounding and related configurations. Only text results are returned. */