@google/genai 1.27.0 → 1.28.0

package/dist/genai.d.ts

@@ -32,7 +32,7 @@ export declare enum ActivityHandling {
 export declare interface ActivityStart {
 }
 
-/** Optional. Adapter size for tuning. */
+/** Adapter size for tuning. This enum is not supported in Gemini API. */
 export declare enum AdapterSize {
     /**
      * Adapter size is unspecified.
@@ -114,13 +114,13 @@ declare class ApiClient {
     setBaseUrl(url: string): void;
     private constructUrl;
     private shouldPrependVertexProjectPath;
-    request(request: HttpRequest): Promise<HttpResponse>;
+    request(request: HttpRequest): Promise<types.HttpResponse>;
     private patchHttpOptions;
-    requestStream(request: HttpRequest): Promise<AsyncGenerator<HttpResponse>>;
+    requestStream(request: HttpRequest): Promise<AsyncGenerator<types.HttpResponse>>;
     private includeExtraHttpOptionsToRequestInit;
     private unaryApiCall;
     private streamApiCall;
-    processStreamResponse(response: Response): AsyncGenerator<HttpResponse>;
+    processStreamResponse(response: Response): AsyncGenerator<types.HttpResponse>;
     private apiCall;
     getDefaultHeaders(): Record<string, string>;
     private getHeadersInternal;
@@ -130,19 +130,19 @@ declare class ApiClient {
      *
      * @param file The string path to the file to be uploaded or a Blob object.
      * @param config Optional parameters specified in the `UploadFileConfig`
-     *     interface. @see {@link UploadFileConfig}
+     *     interface. @see {@link types.UploadFileConfig}
      * @return A promise that resolves to a `File` object.
      * @throws An error if called on a Vertex AI client.
      * @throws An error if the `mimeType` is not provided and can not be inferred,
      */
-    uploadFile(file: string | Blob, config?: UploadFileConfig): Promise<File_2>;
+    uploadFile(file: string | Blob, config?: types.UploadFileConfig): Promise<types.File>;
     /**
      * Downloads a file asynchronously to the specified path.
      *
      * @params params - The parameters for the download request, see {@link
-     * DownloadFileParameters}
+     * types.DownloadFileParameters}
      */
-    downloadFile(params: DownloadFileParameters): Promise<void>;
+    downloadFile(params: types.DownloadFileParameters): Promise<void>;
     private fetchUploadUrl;
 }
 
@@ -195,7 +195,7 @@ declare interface ApiClientInitOptions {
     /**
      * Optional. A set of customizable configuration for HTTP requests.
      */
-    httpOptions?: HttpOptions;
+    httpOptions?: types.HttpOptions;
     /**
      * Optional. An extra string to append at the end of the User-Agent header.
      *
@@ -234,7 +234,7 @@ export declare interface ApiKeyConfig {
     apiKeyString?: string;
 }
 
-/** The API spec that the external API implements. */
+/** The API spec that the external API implements. This enum is not supported in Gemini API. */
 export declare enum ApiSpec {
     /**
      * Unspecified API spec. This value should not be used.
@@ -333,7 +333,7 @@ export declare interface AuthToken {
     name?: string;
 }
 
-/** Type of auth scheme. */
+/** Type of auth scheme. This enum is not supported in Gemini API. */
 export declare enum AuthType {
     AUTH_TYPE_UNSPECIFIED = "AUTH_TYPE_UNSPECIFIED",
     /**
@@ -635,11 +635,11 @@ export declare enum Behavior {
 
 /** Content blob. */
 declare interface Blob_2 {
-    /** Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is not currently used in the Gemini GenerateContent calls. */
-    displayName?: string;
     /** Required. Raw bytes.
      * @remarks Encoded as base64 string. */
     data?: string;
+    /** Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. This field is not supported in Gemini API. */
+    displayName?: string;
     /** Required. The IANA standard MIME type of the source data. */
     mimeType?: string;
 }
@@ -896,8 +896,6 @@ export declare interface Candidate {
      If empty, the model has not stopped generating the tokens.
      */
     finishReason?: FinishReason;
-    /** Metadata related to url context retrieval tool. */
-    urlContextMetadata?: UrlContextMetadata;
     /** Output only. Average log probability score of the candidate. */
     avgLogprobs?: number;
     /** Output only. Metadata specifies sources used to ground generated content. */
@@ -908,6 +906,8 @@ export declare interface Candidate {
     logprobsResult?: LogprobsResult;
     /** Output only. List of ratings for the safety of a response candidate. There is at most one rating per category. */
     safetyRatings?: SafetyRating[];
+    /** Output only. Metadata related to url context retrieval tool. */
+    urlContextMetadata?: UrlContextMetadata;
 }
 
 /**
@@ -1125,9 +1125,7 @@ export declare interface Content {
     /** List of parts that constitute a single message. Each part may have
      a different IANA MIME type. */
     parts?: Part[];
-    /** Optional. The producer of the content. Must be either 'user' or
-     'model'. Useful to set for multi-turn conversations, otherwise can be
-     empty. If role is not specified, SDK will determine the role. */
+    /** Optional. The producer of the content. Must be either 'user' or 'model'. Useful to set for multi-turn conversations, otherwise can be left blank or unset. */
     role?: string;
 }
 
@@ -1528,7 +1526,7 @@ export declare function createPartFromText(text: string): Part;
  */
 export declare function createPartFromUri(uri: string, mimeType: string): Part;
 
-/** Supervised fine-tuning job creation request - optional fields. */
+/** Fine-tuning job creation request - optional fields. */
 export declare interface CreateTuningJobConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
@@ -1539,6 +1537,8 @@ export declare interface CreateTuningJobConfig {
      be charged usage for any applicable operations.
      */
     abortSignal?: AbortSignal;
+    /** The method to use for tuning (SUPERVISED_FINE_TUNING or PREFERENCE_TUNING). If not set, the default method (SFT) will be used. */
+    method?: TuningMethod;
     /** Validation dataset for tuning. The dataset must be formatted as a JSONL file. */
     validationDataset?: TuningValidationDataset;
     /** The display name of the tuned Model. The name can be up to 128 characters long and can consist of any UTF-8 characters. */
@@ -1549,7 +1549,7 @@ export declare interface CreateTuningJobConfig {
     epochCount?: number;
     /** Multiplier for adjusting the default learning rate. */
     learningRateMultiplier?: number;
-    /** If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. */
+    /** If set to true, disable intermediate checkpoints and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints. */
     exportLastCheckpointOnly?: boolean;
     /** The optional checkpoint id of the pre-tuned model to use for tuning, if applicable. */
     preTunedModelCheckpointId?: string;
@@ -1561,9 +1561,11 @@ export declare interface CreateTuningJobConfig {
     learningRate?: number;
     /** Optional. The labels with user-defined metadata to organize TuningJob and generated resources such as Model and Endpoint. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. */
     labels?: Record<string, string>;
+    /** Weight for KL Divergence regularization, Preference Optimization tuning only. */
+    beta?: number;
 }
 
-/** Supervised fine-tuning job creation parameters - optional fields. */
+/** Fine-tuning job creation parameters - optional fields. */
 export declare interface CreateTuningJobParameters {
     /** The base model that is being tuned, e.g., "gemini-2.5-flash". */
     baseModel: string;
@@ -1573,7 +1575,7 @@ export declare interface CreateTuningJobParameters {
     config?: CreateTuningJobConfig;
 }
 
-/** Supervised fine-tuning job creation parameters - optional fields. */
+/** Fine-tuning job creation parameters - optional fields. */
 export declare interface CreateTuningJobParametersPrivate {
     /** The base model that is being tuned, e.g., "gemini-2.5-flash". */
     baseModel?: string;
@@ -2021,7 +2023,7 @@ export declare enum EndSensitivity {
     END_SENSITIVITY_LOW = "END_SENSITIVITY_LOW"
 }
 
-/** Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. */
+/** Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. This data type is not supported in Gemini API. */
 export declare interface EnterpriseWebSearch {
     /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. */
     excludeDomains?: string[];
@@ -2149,7 +2151,7 @@ export { File_2 as File }
 
 /** URI based data. */
 export declare interface FileData {
-    /** Optional. Display name of the file data. Used to provide a label or filename to distinguish file datas. It is not currently used in the Gemini GenerateContent calls. */
+    /** Optional. Display name of the file data. Used to provide a label or filename to distinguish file datas. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. This field is not supported in Gemini API. */
     displayName?: string;
     /** Required. URI. */
     fileUri?: string;
@@ -3447,14 +3449,12 @@ export declare interface GoogleRpcStatus {
     message?: string;
 }
 
-/** Tool to support Google Search in Model. Powered by Google. */
+/** GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
 export declare interface GoogleSearch {
-    /** Optional. Filter search results to a specific time range.
-     If customers set a start time, they must set an end time (and vice versa).
-     */
-    timeRangeFilter?: Interval;
     /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"]. This field is not supported in Gemini API. */
     excludeDomains?: string[];
+    /** Optional. Filter search results to a specific time range. If customers set a start time, they must set an end time (and vice versa). This field is not supported in Vertex AI. */
+    timeRangeFilter?: Interval;
 }
 
 /** Tool to retrieve public web data for grounding, powered by Google. */
@@ -3595,7 +3595,7 @@ export declare interface GroundingSupport {
     segment?: Segment;
 }
 
-/** Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score. */
+/** Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score. This enum is not supported in Gemini API. */
 export declare enum HarmBlockMethod {
     /**
      * The harm block method is unspecified.
@@ -3611,7 +3611,7 @@ export declare enum HarmBlockMethod {
     PROBABILITY = "PROBABILITY"
 }
 
-/** Required. The harm block threshold. */
+/** The harm block threshold. */
 export declare enum HarmBlockThreshold {
     /**
      * Unspecified harm block threshold.
@@ -3639,7 +3639,7 @@ export declare enum HarmBlockThreshold {
     OFF = "OFF"
 }
 
-/** Required. Harm category. */
+/** Harm category. */
 export declare enum HarmCategory {
     /**
      * The harm category is unspecified.
@@ -3711,7 +3711,7 @@ export declare enum HarmProbability {
     HIGH = "HIGH"
 }
 
-/** Output only. Harm severity levels in the content. */
+/** Output only. Harm severity levels in the content. This enum is not supported in Gemini API. */
 export declare enum HarmSeverity {
     /**
      * Harm severity unspecified.
@@ -3794,7 +3794,7 @@ declare interface HttpRequest {
     /**
      * Optional set of customizable configuration for HTTP requests.
      */
-    httpOptions?: HttpOptions;
+    httpOptions?: types.HttpOptions;
     /**
      * Optional abort signal which can be used to cancel the request.
      */
@@ -3905,17 +3905,12 @@ export declare class InlinedResponse {
     error?: JobError;
 }
 
-/** Represents a time interval, encoded as a start time (inclusive) and an end time (exclusive).
-
- The start time must be less than or equal to the end time.
- When the start equals the end time, the interval is an empty interval.
- (matches no time)
- When both start and end are unspecified, the interval matches any time. */
+/** Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. */
 export declare interface Interval {
-    /** The start time of the interval. */
-    startTime?: string;
-    /** The end time of the interval. */
+    /** Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end. */
     endTime?: string;
+    /** Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start. */
+    startTime?: string;
 }
 
 /** Job error. */
@@ -3980,7 +3975,7 @@ export declare enum JobState {
     JOB_STATE_PARTIALLY_SUCCEEDED = "JOB_STATE_PARTIALLY_SUCCEEDED"
 }
 
-/** Required. Programming language of the `code`. */
+/** Programming language of the `code`. */
 export declare enum Language {
     /**
      * Unspecified language. This value should not be used.
@@ -5489,9 +5484,9 @@ export declare interface ModelSelectionConfig {
     featureSelectionPreference?: FeatureSelectionPreference;
 }
 
-/** The configuration for the multi-speaker setup. */
+/** The configuration for the multi-speaker setup. This data type is not supported in Vertex AI. */
 export declare interface MultiSpeakerVoiceConfig {
-    /** The configuration for the speaker to use. */
+    /** Required. All the enabled speaker voices. */
     speakerVoiceConfigs?: SpeakerVoiceConfig[];
 }
 
@@ -5574,7 +5569,7 @@ export declare class Operations extends BaseModule {
     private fetchPredictVideosOperationInternal;
 }
 
-/** Required. Outcome of the code execution. */
+/** Outcome of the code execution. */
 export declare enum Outcome {
     /**
      * Unspecified status. This value should not be used.
@@ -5599,10 +5594,13 @@ export declare enum PagedItem {
     PAGED_ITEM_MODELS = "models",
     PAGED_ITEM_TUNING_JOBS = "tuningJobs",
     PAGED_ITEM_FILES = "files",
-    PAGED_ITEM_CACHED_CONTENTS = "cachedContents"
+    PAGED_ITEM_CACHED_CONTENTS = "cachedContents",
+    PAGED_ITEM_RAG_STORES = "ragStores",
+    PAGED_ITEM_DOCUMENTS = "documents"
 }
 
 declare interface PagedItemConfig {
+    parent?: string;
     config?: {
         pageToken?: string;
         pageSize?: number;
@@ -5617,6 +5615,8 @@ declare interface PagedItemResponse<T> {
     tuningJobs?: T[];
     files?: T[];
     cachedContents?: T[];
+    ragStores?: T[];
+    documents?: T[];
 }
 
 /**
@@ -5725,17 +5725,6 @@ export declare class Pager<T> implements AsyncIterable<T> {
  of content being conveyed. Using multiple fields within the same `Part`
  instance is considered invalid. */
 export declare interface Part {
-    /** Metadata for a given video. */
-    videoMetadata?: VideoMetadata;
-    /** Indicates if the part is thought from the model. */
-    thought?: boolean;
-    /** Optional. Inlined bytes data. */
-    inlineData?: Blob_2;
-    /** Optional. URI based data. */
-    fileData?: FileData;
-    /** An opaque signature for the thought so it can be reused in subsequent requests.
-     * @remarks Encoded as base64 string. */
-    thoughtSignature?: string;
     /** A predicted [FunctionCall] returned from the model that contains a string
      representing the [FunctionDeclaration.name] and a structured JSON object
      containing the parameters and their values. */
@@ -5744,10 +5733,21 @@ export declare interface Part {
     codeExecutionResult?: CodeExecutionResult;
     /** Optional. Code generated by the model that is meant to be executed. */
     executableCode?: ExecutableCode;
+    /** Optional. URI based data. */
+    fileData?: FileData;
     /** Optional. The result output of a [FunctionCall] that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing any output from the function call. It is used as context to the model. */
     functionResponse?: FunctionResponse;
+    /** Optional. Inlined bytes data. */
+    inlineData?: Blob_2;
     /** Optional. Text part (can be code). */
     text?: string;
+    /** Optional. Indicates if the part is thought from the model. */
+    thought?: boolean;
+    /** Optional. An opaque signature for the thought so it can be reused in subsequent requests.
+     * @remarks Encoded as base64 string. */
+    thoughtSignature?: string;
+    /** Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data. */
+    videoMetadata?: VideoMetadata;
 }
 
 export declare type PartListUnion = PartUnion[] | PartUnion;
@@ -5782,7 +5782,7 @@ export declare enum PersonGeneration {
 
 /** The configuration for the prebuilt speaker to use. */
 export declare interface PrebuiltVoiceConfig {
-    /** The name of the prebuilt voice to use. */
+    /** The name of the preset voice to use. */
     voiceName?: string;
 }
 
@@ -5806,6 +5806,28 @@ export declare interface PreferenceOptimizationDataStats {
     userOutputTokenDistribution?: DatasetDistribution;
 }
 
+/** Hyperparameters for Preference Optimization. This data type is not supported in Gemini API. */
+export declare interface PreferenceOptimizationHyperParameters {
+    /** Optional. Adapter size for preference optimization. */
+    adapterSize?: AdapterSize;
+    /** Optional. Weight for KL Divergence regularization. */
+    beta?: number;
+    /** Optional. Number of complete passes the model makes over the entire training dataset during training. */
+    epochCount?: string;
+    /** Optional. Multiplier for adjusting the default learning rate. */
+    learningRateMultiplier?: number;
+}
+
+/** Preference optimization tuning spec for tuning. */
+export declare interface PreferenceOptimizationSpec {
+    /** Optional. Hyperparameters for Preference Optimization. */
+    hyperParameters?: PreferenceOptimizationHyperParameters;
+    /** Required. Cloud Storage path to file containing training dataset for preference optimization tuning. The dataset must be formatted as a JSONL file. */
+    trainingDatasetUri?: string;
+    /** Optional. Cloud Storage path to file containing validation dataset for preference optimization tuning. The dataset must be formatted as a JSONL file. */
+    validationDatasetUri?: string;
+}
+
 /** A pre-tuned model for continuous tuning. This data type is not supported in Gemini API. */
 export declare interface PreTunedModel {
     /** Output only. The name of the base model this PreTunedModel was tuned from. */
@@ -6089,13 +6111,13 @@ export declare interface SafetyRating {
     blocked?: boolean;
     /** Output only. Harm category. */
     category?: HarmCategory;
-    /** Output only. The overwritten threshold for the safety category of Gemini 2.0 image out. If minors are detected in the output image, the threshold of each safety category will be overwritten if user sets a lower threshold. */
+    /** Output only. The overwritten threshold for the safety category of Gemini 2.0 image out. If minors are detected in the output image, the threshold of each safety category will be overwritten if user sets a lower threshold. This field is not supported in Gemini API. */
     overwrittenThreshold?: HarmBlockThreshold;
     /** Output only. Harm probability levels in the content. */
     probability?: HarmProbability;
     /** Output only. Harm probability score. This field is not supported in Gemini API. */
     probabilityScore?: number;
-    /** Output only. Harm severity levels in the content. */
+    /** Output only. Harm severity levels in the content. This field is not supported in Gemini API. */
     severity?: HarmSeverity;
     /** Output only. Harm severity score. This field is not supported in Gemini API. */
     severityScore?: number;
@@ -6103,11 +6125,10 @@ export declare interface SafetyRating {
 
 /** Safety settings. */
 export declare interface SafetySetting {
-    /** Determines if the harm block method uses probability or probability
-     and severity scores. */
-    method?: HarmBlockMethod;
     /** Required. Harm category. */
     category?: HarmCategory;
+    /** Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score. This field is not supported in Gemini API. */
+    method?: HarmBlockMethod;
     /** Required. The harm block threshold. */
     threshold?: HarmBlockThreshold;
 }
@@ -6521,28 +6542,22 @@ export declare interface SlidingWindow {
     targetTokens?: string;
 }
 
-/** The configuration for the speaker to use. */
+/** The configuration for a single speaker in a multi speaker setup. This data type is not supported in Vertex AI. */
 export declare interface SpeakerVoiceConfig {
-    /** The name of the speaker to use. Should be the same as in the
-     prompt. */
+    /** Required. The name of the speaker to use. Should be the same as in the prompt. */
     speaker?: string;
-    /** The configuration for the voice to use. */
+    /** Required. The configuration for the voice to use. */
     voiceConfig?: VoiceConfig;
 }
 
-/** The speech generation configuration. */
+/** The speech generation config. */
 export declare interface SpeechConfig {
-    /** The configuration for the speaker to use.
-     */
+    /** Optional. Language code (ISO 639. e.g. en-US) for the speech synthesization. */
+    languageCode?: string;
+    /** The configuration for the speaker to use. */
     voiceConfig?: VoiceConfig;
-    /** The configuration for the multi-speaker setup.
-     It is mutually exclusive with the voice_config field.
-     */
+    /** Optional. The configuration for the multi-speaker setup. It is mutually exclusive with the voice_config field. This field is not supported in Vertex AI. */
     multiSpeakerVoiceConfig?: MultiSpeakerVoiceConfig;
-    /** 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;
@@ -6698,7 +6713,7 @@ export declare interface SupervisedTuningDataStats {
     userOutputTokenDistribution?: SupervisedTuningDatasetDistribution;
 }
 
-/** Tuning Spec for Supervised Tuning for first party models. This data type is not supported in Gemini API. */
+/** Supervised tuning spec for tuning. */
 export declare interface SupervisedTuningSpec {
     /** Optional. If set to true, disable intermediate checkpoints for SFT and only the last checkpoint will be exported. Otherwise, enable intermediate checkpoints for SFT. Default is false. */
     exportLastCheckpointOnly?: boolean;
@@ -6854,25 +6869,23 @@ export declare interface Tool {
     functionDeclarations?: FunctionDeclaration[];
     /** Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. This field is not supported in Gemini API. */
     retrieval?: Retrieval;
-    /** Optional. Google Search tool type. Specialized retrieval tool
-     that is powered by Google Search. */
-    googleSearch?: GoogleSearch;
     /** Optional. GoogleSearchRetrieval tool type. Specialized retrieval tool that is powered by Google search. */
     googleSearchRetrieval?: GoogleSearchRetrieval;
-    /** Optional. Enterprise web search tool type. Specialized retrieval
-     tool that is powered by Vertex AI Search and Sec4 compliance. */
-    enterpriseWebSearch?: EnterpriseWebSearch;
     /** Optional. Google Maps tool type. Specialized retrieval tool
      that is powered by Google Maps. */
     googleMaps?: GoogleMaps;
-    /** Optional. Tool to support URL context retrieval. */
-    urlContext?: UrlContext;
     /** Optional. Tool to support the model interacting directly with the
      computer. If enabled, it automatically populates computer-use specific
      Function Declarations. */
     computerUse?: ComputerUse;
     /** Optional. CodeExecution tool type. Enables the model to execute code as part of generation. */
     codeExecution?: ToolCodeExecution;
+    /** Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance. This field is not supported in Gemini API. */
+    enterpriseWebSearch?: EnterpriseWebSearch;
+    /** Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
+    googleSearch?: GoogleSearch;
+    /** Optional. Tool to support URL context retrieval. */
+    urlContext?: UrlContext;
 }
 
 /** Tool that executes code generated by the model, and automatically returns the result to the model. See also [ExecutableCode]and [CodeExecutionResult] which are input and output to this tool. This data type is not supported in Gemini API. */
@@ -6893,7 +6906,7 @@ export declare type ToolListUnion = ToolUnion[];
 
 export declare type ToolUnion = Tool | CallableTool;
 
-/** Output only. Traffic type. This shows whether a request consumes Pay-As-You-Go or Provisioned Throughput quota. */
+/** Output only. Traffic type. This shows whether a request consumes Pay-As-You-Go or Provisioned Throughput quota. This enum is not supported in Gemini API. */
 export declare enum TrafficType {
     /**
      * Unspecified request traffic type.
@@ -7021,6 +7034,8 @@ export declare interface TuningJob {
     preTunedModel?: PreTunedModel;
     /** Tuning Spec for Supervised Fine Tuning. */
     supervisedTuningSpec?: SupervisedTuningSpec;
+    /** Tuning Spec for Preference Optimization. */
+    preferenceOptimizationSpec?: PreferenceOptimizationSpec;
     /** Output only. The tuning data statistics associated with this TuningJob. */
     tuningDataStats?: TuningDataStats;
     /** Customer-managed encryption key options for a TuningJob. If this is set, then all resources created by the TuningJob will be encrypted with the provided encryption key. */
@@ -7045,7 +7060,19 @@ export declare interface TuningJob {
     veoTuningSpec?: VeoTuningSpec;
 }
 
-/** Tuning mode. */
+/** Enum representing the tuning method. */
+export declare enum TuningMethod {
+    /**
+     * Supervised fine tuning.
+     */
+    SUPERVISED_FINE_TUNING = "SUPERVISED_FINE_TUNING",
+    /**
+     * Preference optimization tuning.
+     */
+    PREFERENCE_TUNING = "PREFERENCE_TUNING"
+}
+
+/** Tuning mode. This enum is not supported in Gemini API. */
 export declare enum TuningMode {
     /**
      * Tuning mode is unspecified.
@@ -7126,7 +7153,7 @@ declare class Tunings extends BaseModule {
     private tuneMldevInternal;
 }
 
-/** Optional. The tuning task. Either I2V or T2V. */
+/** The tuning task. Either I2V or T2V. This enum is not supported in Gemini API. */
 export declare enum TuningTask {
     /**
      * Default value. This value is unused.
@@ -7185,7 +7212,7 @@ export declare enum TurnCoverage {
     TURN_INCLUDES_ALL_INPUT = "TURN_INCLUDES_ALL_INPUT"
 }
 
-/** Optional. The type of the data. */
+/** The type of the data. */
 export declare enum Type {
     /**
      * Not specified, should not be used.
@@ -7238,23 +7265,23 @@ declare namespace types {
         Language,
         FunctionResponseScheduling,
         Type,
-        HarmCategory,
-        HarmBlockMethod,
-        HarmBlockThreshold,
         Mode,
         AuthType,
         ApiSpec,
-        UrlRetrievalStatus,
+        HarmCategory,
+        HarmBlockMethod,
+        HarmBlockThreshold,
         FinishReason,
         HarmProbability,
         HarmSeverity,
+        UrlRetrievalStatus,
         BlockedReason,
         TrafficType,
         Modality,
         MediaResolution,
-        JobState,
         TuningMode,
         AdapterSize,
+        JobState,
         TuningTask,
         FeatureSelectionPreference,
         Behavior,
@@ -7272,6 +7299,7 @@ declare namespace types {
         VideoGenerationReferenceType,
         VideoGenerationMaskMode,
         VideoCompressionQuality,
+        TuningMethod,
         FileState,
         FileSource,
         TurnCompleteReason,
@@ -7283,28 +7311,24 @@ declare namespace types {
         Scale,
         MusicGenerationMode,
         LiveMusicPlaybackControl,
-        VideoMetadata,
-        Blob_2 as Blob,
-        FileData,
         FunctionCall,
         CodeExecutionResult,
         ExecutableCode,
+        FileData,
         FunctionResponseBlob,
         FunctionResponseFileData,
         FunctionResponsePart,
         FunctionResponse,
+        Blob_2 as Blob,
+        VideoMetadata,
         Part,
         Content,
         HttpOptions,
         Schema,
         ModelSelectionConfig,
-        SafetySetting,
         FunctionDeclaration,
-        Interval,
-        GoogleSearch,
         DynamicRetrievalConfig,
         GoogleSearchRetrieval,
-        EnterpriseWebSearch,
         ApiKeyConfig,
         AuthConfigGoogleServiceAccountConfig,
         AuthConfigHttpBasicAuthConfig,
@@ -7312,7 +7336,6 @@ declare namespace types {
         AuthConfigOidcConfig,
         AuthConfig,
         GoogleMaps,
-        UrlContext,
         ComputerUse,
         ApiAuthApiKeyConfig,
         ApiAuth,
@@ -7331,22 +7354,22 @@ declare namespace types {
         VertexRagStore,
         Retrieval,
         ToolCodeExecution,
+        EnterpriseWebSearch,
+        Interval,
+        GoogleSearch,
+        UrlContext,
         Tool,
         FunctionCallingConfig,
         LatLng,
         RetrievalConfig,
         ToolConfig,
-        PrebuiltVoiceConfig,
-        VoiceConfig,
-        SpeakerVoiceConfig,
-        MultiSpeakerVoiceConfig,
-        SpeechConfig,
         AutomaticFunctionCallingConfig,
         ThinkingConfig,
         ImageConfig,
         GenerationConfigRoutingConfigAutoRoutingMode,
         GenerationConfigRoutingConfigManualRoutingMode,
         GenerationConfigRoutingConfig,
+        SafetySetting,
         GenerateContentConfig,
         GenerateContentParameters,
         HttpResponse,
@@ -7354,8 +7377,6 @@ declare namespace types {
         GoogleTypeDate,
         Citation,
         CitationMetadata,
-        UrlMetadata,
-        UrlContextMetadata,
         GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution,
         GroundingChunkMapsPlaceAnswerSourcesReviewSnippet,
         GroundingChunkMapsPlaceAnswerSources,
@@ -7375,6 +7396,8 @@ declare namespace types {
         LogprobsResultTopCandidates,
         LogprobsResult,
         SafetyRating,
+        UrlMetadata,
+        UrlContextMetadata,
         Candidate,
         GenerateContentResponsePromptFeedback,
         ModalityTokenCount,
@@ -7427,6 +7450,11 @@ declare namespace types {
         DeleteModelConfig,
         DeleteModelParameters,
         DeleteModelResponse,
+        PrebuiltVoiceConfig,
+        VoiceConfig,
+        SpeakerVoiceConfig,
+        MultiSpeakerVoiceConfig,
+        SpeechConfig,
         GenerationConfig,
         CountTokensConfig,
         CountTokensParameters,
@@ -7449,10 +7477,12 @@ declare namespace types {
         GetTuningJobParameters,
         TunedModelCheckpoint,
         TunedModel,
-        GoogleRpcStatus,
-        PreTunedModel,
         SupervisedHyperParameters,
         SupervisedTuningSpec,
+        PreferenceOptimizationHyperParameters,
+        PreferenceOptimizationSpec,
+        GoogleRpcStatus,
+        PreTunedModel,
         DatasetDistributionDistributionBucket,
         DatasetDistribution,
         DatasetStats,
@@ -7738,6 +7768,10 @@ export declare interface UpscaleImageConfig {
     abortSignal?: AbortSignal;
     /** Cloud Storage URI used to store the generated images. */
     outputGcsUri?: string;
+    /** Filter level for safety filtering. */
+    safetyFilterLevel?: SafetyFilterLevel;
+    /** Allows generation of people by the model. */
+    personGeneration?: PersonGeneration;
     /** Whether to include a reason for filtered-out images in the
      response. */
     includeRaiReason?: boolean;
@@ -7778,19 +7812,19 @@ export declare class UpscaleImageResponse {
     generatedImages?: GeneratedImage[];
 }
 
-/** Tool to support URL context retrieval. */
+/** Tool to support URL context. */
 export declare interface UrlContext {
 }
 
 /** Metadata related to url context retrieval tool. */
 export declare interface UrlContextMetadata {
-    /** List of url context. */
+    /** Output only. List of url context. */
     urlMetadata?: UrlMetadata[];
 }
 
-/** Context for a single url retrieval. */
+/** Context of the a single url retrieval. */
 export declare interface UrlMetadata {
-    /** The URL retrieved by the tool. */
+    /** Retrieved url by the tool. */
     retrievedUrl?: string;
     /** Status of the url retrieval. */
     urlRetrievalStatus?: UrlRetrievalStatus;
@@ -7799,7 +7833,7 @@ export declare interface UrlMetadata {
 /** Status of the url retrieval. */
 export declare enum UrlRetrievalStatus {
     /**
-     * Default value. This value is unused
+     * Default value. This value is unused.
      */
     URL_RETRIEVAL_STATUS_UNSPECIFIED = "URL_RETRIEVAL_STATUS_UNSPECIFIED",
     /**
@@ -7811,11 +7845,11 @@ export declare enum UrlRetrievalStatus {
      */
     URL_RETRIEVAL_STATUS_ERROR = "URL_RETRIEVAL_STATUS_ERROR",
     /**
-     * Url retrieval is failed because the content is behind paywall.
+     * Url retrieval is failed because the content is behind paywall. This enum value is not supported in Vertex AI.
      */
     URL_RETRIEVAL_STATUS_PAYWALL = "URL_RETRIEVAL_STATUS_PAYWALL",
     /**
-     * Url retrieval is failed because the content is unsafe.
+     * Url retrieval is failed because the content is unsafe. This enum value is not supported in Vertex AI.
      */
     URL_RETRIEVAL_STATUS_UNSAFE = "URL_RETRIEVAL_STATUS_UNSAFE"
 }
@@ -7999,21 +8033,19 @@ export declare enum VideoGenerationReferenceType {
     STYLE = "STYLE"
 }
 
-/** Describes how the video in the Part should be used by the model. */
+/** Metadata describes the input video content. */
 export declare interface VideoMetadata {
-    /** The frame rate of the video sent to the model. If not specified, the
-     default value will be 1.0. The fps range is (0.0, 24.0]. */
-    fps?: number;
     /** Optional. The end offset of the video. */
     endOffset?: string;
+    /** Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0]. */
+    fps?: number;
     /** Optional. The start offset of the video. */
     startOffset?: string;
 }
 
 /** The configuration for the voice to use. */
 export declare interface VoiceConfig {
-    /** The configuration for the speaker to use.
-     */
+    /** The configuration for the prebuilt voice to use. */
     prebuiltVoiceConfig?: PrebuiltVoiceConfig;
 }