@google/genai 1.13.0 → 1.15.0

package/README.md

@@ -339,6 +339,30 @@ if you are specifying those, you need to explicitly provide the full
 `Content[]` structure making it explicit which Parts are 'spoken' by the model,
 or the user. The SDK will throw an exception if you try this.
 
+## Error Handling
+
+To handle errors raised by the API, the SDK provides this [ApiError](https://github.com/googleapis/js-genai/blob/main/src/errors.ts) class.
+
+```typescript
+import {GoogleGenAI} from '@google/genai';
+const GEMINI_API_KEY = process.env.GEMINI_API_KEY;
+
+const ai = new GoogleGenAI({apiKey: GEMINI_API_KEY});
+
+async function main() {
+  await ai.models.generateContent({
+    model: 'non-existent-model',
+    contents: 'Write a 100-word poem.',
+  }).catch((e) => {
+    console.error('error name: ', e.name);
+    console.error('error message: ', e.message);
+    console.error('error status: ', e.status);
+  });
+}
+
+main();
+```
+
 ## How is this different from the other Google AI SDKs
 This SDK (`@google/genai`) is Google Deepmind’s "vanilla" SDK for its generative
 AI offerings, and is where Google Deepmind adds new AI features.

package/dist/genai.d.ts

@@ -1425,6 +1425,8 @@ export declare interface CreateTuningJobConfig {
     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. */
     exportLastCheckpointOnly?: boolean;
+    /** The optional checkpoint id of the pre-tuned model to use for tuning, if applicable. */
+    preTunedModelCheckpointId?: string;
     /** Adapter size for tuning. */
     adapterSize?: AdapterSize;
     /** The batch size hyperparameter for tuning. If not set, a default of 4 or 16 will be used based on the number of training examples. */
@@ -1435,7 +1437,7 @@ export declare interface CreateTuningJobConfig {
 
 /** Supervised fine-tuning job creation parameters - optional fields. */
 export declare interface CreateTuningJobParameters {
-    /** The base model that is being tuned, e.g., "gemini-1.0-pro-002". */
+    /** The base model that is being tuned, e.g., "gemini-2.5-flash". */
     baseModel: string;
     /** Cloud Storage path to file containing training dataset for tuning. The dataset must be formatted as a JSONL file. */
     trainingDataset: TuningDataset;
@@ -1443,6 +1445,18 @@ export declare interface CreateTuningJobParameters {
     config?: CreateTuningJobConfig;
 }
 
+/** Supervised 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;
+    /** The PreTunedModel that is being tuned. */
+    preTunedModel?: PreTunedModel;
+    /** Cloud Storage path to file containing training dataset for tuning. The dataset must be formatted as a JSONL file. */
+    trainingDataset: TuningDataset;
+    /** Configuration for the tuning job. */
+    config?: CreateTuningJobConfig;
+}
+
 /**
  * Creates a `Content` object with a user role from a `PartListUnion` object or `string`.
  */
@@ -1612,34 +1626,6 @@ export declare interface DistillationDataStats {
     trainingDatasetStats?: DatasetStats;
 }
 
-/** Hyperparameters for Distillation. */
-export declare interface DistillationHyperParameters {
-    /** Optional. Adapter size for distillation. */
-    adapterSize?: AdapterSize;
-    /** 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;
-}
-
-/** Tuning Spec for Distillation. */
-export declare interface DistillationSpec {
-    /** The base teacher model that is being distilled. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/tuning#supported_models). */
-    baseTeacherModel?: string;
-    /** Optional. Hyperparameters for Distillation. */
-    hyperParameters?: DistillationHyperParameters;
-    /** Deprecated. A path in a Cloud Storage bucket, which will be treated as the root output directory of the distillation pipeline. It is used by the system to generate the paths of output artifacts. */
-    pipelineRootDirectory?: string;
-    /** The student model that is being tuned, e.g., "google/gemma-2b-1.1-it". Deprecated. Use base_model instead. */
-    studentModel?: string;
-    /** Deprecated. Cloud Storage path to file containing training dataset for tuning. The dataset must be formatted as a JSONL file. */
-    trainingDatasetUri?: string;
-    /** The resource name of the Tuned teacher model. Format: `projects/{project}/locations/{location}/models/{model}`. */
-    tunedTeacherModelSource?: string;
-    /** Optional. Cloud Storage path to file containing validation dataset for tuning. The dataset must be formatted as a JSONL file. */
-    validationDatasetUri?: string;
-}
-
 export declare type DownloadableFileUnion = string | File_2 | GeneratedVideo | Video;
 
 declare interface Downloader {
@@ -1895,9 +1881,19 @@ export declare enum EndSensitivity {
 
 /** Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. */
 export declare interface EnterpriseWebSearch {
+    /** Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. */
+    excludeDomains?: string[];
+}
+
+/** An entity representing the segmented area. */
+export declare interface EntityLabel {
+    /** The label of the segmented entity. */
+    label?: string;
+    /** The confidence score of the detected label. */
+    score?: number;
 }
 
-/** Required. The environment being operated. */
+/** The environment being operated. */
 export declare enum Environment {
     /**
      * Defaults to browser.
@@ -2331,6 +2327,22 @@ export declare enum FunctionResponseScheduling {
     INTERRUPT = "INTERRUPT"
 }
 
+/** Input example for preference optimization. */
+export declare interface GeminiPreferenceExample {
+    /** List of completions for a given prompt. */
+    completions?: GeminiPreferenceExampleCompletion[];
+    /** Multi-turn contents that represents the Prompt. */
+    contents?: Content[];
+}
+
+/** Completion and its preference score. */
+export declare interface GeminiPreferenceExampleCompletion {
+    /** Single turn completion for the given prompt. */
+    completion?: Content;
+    /** The score for the given completion. */
+    score?: number;
+}
+
 /** Optional model configuration parameters.
 
  For more information, see `Content generation parameters
@@ -2698,6 +2710,14 @@ export declare interface GeneratedImage {
     enhancedPrompt?: string;
 }
 
+/** A generated image mask. */
+export declare interface GeneratedImageMask {
+    /** The generated image mask. */
+    mask?: Image_2;
+    /** The detected entities on the segmented area. */
+    labels?: EntityLabel[];
+}
+
 /** A generated video. */
 export declare interface GeneratedVideo {
     /** The output video */
@@ -2836,6 +2856,12 @@ export declare interface GenerateVideosConfig {
     generateAudio?: boolean;
     /** Image to use as the last frame of generated videos. Only supported for image to video use cases. */
     lastFrame?: Image_2;
+    /** The images to use as the references to generate the videos.
+     If this field is provided, the text prompt field must also be provided.
+     The image, video, or last_frame field are not supported. Each image must
+     be associated with a type. Veo 2 supports up to 3 asset images *or* 1
+     style image. */
+    referenceImages?: VideoGenerationReferenceImage[];
     /** Compression quality of the generated videos. */
     compressionQuality?: VideoCompressionQuality;
 }
@@ -2960,7 +2986,7 @@ export declare interface GenerationConfigRoutingConfigManualRoutingMode {
 export declare interface GenerationConfigThinkingConfig {
     /** Optional. Indicates whether to include thoughts in the response. If true, thoughts are returned only when available. */
     includeThoughts?: boolean;
-    /** Optional. Indicates the thinking budget in tokens. This is only applied when enable_thinking is true. */
+    /** Optional. Indicates the thinking budget in tokens. */
     thinkingBudget?: number;
 }
 
@@ -3224,6 +3250,9 @@ export declare interface GoogleSearch {
      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. */
+    excludeDomains?: string[];
 }
 
 /** Tool to retrieve public web data for grounding, powered by Google. */
@@ -3244,14 +3273,64 @@ export declare interface GoogleTypeDate {
 
 /** Grounding chunk. */
 export declare interface GroundingChunk {
+    /** Grounding chunk from Google Maps. */
+    maps?: GroundingChunkMaps;
     /** Grounding chunk from context retrieved by the retrieval tools. */
     retrievedContext?: GroundingChunkRetrievedContext;
     /** Grounding chunk from the web. */
     web?: GroundingChunkWeb;
 }
 
+/** Chunk from Google Maps. */
+export declare interface GroundingChunkMaps {
+    /** Sources used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as uris to flag content. */
+    placeAnswerSources?: GroundingChunkMapsPlaceAnswerSources;
+    /** This Place's resource name, in `places/{place_id}` format. Can be used to look up the Place. */
+    placeId?: string;
+    /** Text of the chunk. */
+    text?: string;
+    /** Title of the chunk. */
+    title?: string;
+    /** URI reference of the chunk. */
+    uri?: string;
+}
+
+/** Sources used to generate the place answer. */
+export declare interface GroundingChunkMapsPlaceAnswerSources {
+    /** A link where users can flag a problem with the generated answer. */
+    flagContentUri?: string;
+    /** Snippets of reviews that are used to generate the answer. */
+    reviewSnippets?: GroundingChunkMapsPlaceAnswerSourcesReviewSnippet[];
+}
+
+/** Author attribution for a photo or review. */
+export declare interface GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution {
+    /** Name of the author of the Photo or Review. */
+    displayName?: string;
+    /** Profile photo URI of the author of the Photo or Review. */
+    photoUri?: string;
+    /** URI of the author of the Photo or Review. */
+    uri?: string;
+}
+
+/** Encapsulates a review snippet. */
+export declare interface GroundingChunkMapsPlaceAnswerSourcesReviewSnippet {
+    /** This review's author. */
+    authorAttribution?: GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution;
+    /** A link where users can flag a problem with the review. */
+    flagContentUri?: string;
+    /** A link to show the review on Google Maps. */
+    googleMapsUri?: string;
+    /** A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country. */
+    relativePublishTimeDescription?: string;
+    /** A reference representing this place review which may be used to look up this place review again. */
+    review?: string;
+}
+
 /** Chunk from context retrieved by the retrieval tools. */
 export declare interface GroundingChunkRetrievedContext {
+    /** Output only. The full document name for the referenced Vertex AI Search document. */
+    documentName?: string;
     /** Additional context for the RAG retrieval result. This is only populated when using the RAG retrieval tool. */
     ragChunk?: RagChunk;
     /** Text of the attribution. */
@@ -3274,6 +3353,8 @@ export declare interface GroundingChunkWeb {
 
 /** Metadata returned to client when grounding is enabled. */
 export declare interface GroundingMetadata {
+    /** Optional. Output only. Resource name of the Google Maps widget context token to be used with the PlacesContextElement widget to render contextual data. This is populated only for Google Maps grounding. */
+    googleMapsWidgetContextToken?: string;
     /** List of supporting references retrieved from specified grounding source. */
     groundingChunks?: GroundingChunk[];
     /** Optional. List of grounding support. */
@@ -5068,6 +5149,27 @@ export declare class Models extends BaseModule {
      * ```
      */
     recontextImage(params: types.RecontextImageParameters): Promise<types.RecontextImageResponse>;
+    /**
+     * Segments an image, creating a mask of a specified area.
+     *
+     * @param params - The parameters for segmenting an image.
+     * @return The response from the API.
+     *
+     * @example
+     * ```ts
+     * const response = await ai.models.segmentImage({
+     *  model: 'image-segmentation-001',
+     *  source: {
+     *    image: image,
+     *  },
+     *  config: {
+     *    mode: 'foreground',
+     *  },
+     * });
+     * console.log(response?.generatedMasks?.[0]?.mask?.imageBytes);
+     * ```
+     */
+    segmentImage(params: types.SegmentImageParameters): Promise<types.SegmentImageResponse>;
     /**
      * Fetches information about a model by name.
      *
@@ -5472,6 +5574,36 @@ export declare interface PrebuiltVoiceConfig {
     voiceName?: string;
 }
 
+/** Statistics computed for datasets used for preference optimization. */
+export declare interface PreferenceOptimizationDataStats {
+    /** Output only. Dataset distributions for scores variance per example. */
+    scoreVariancePerExampleDistribution?: DatasetDistribution;
+    /** Output only. Dataset distributions for scores. */
+    scoresDistribution?: DatasetDistribution;
+    /** Output only. Number of billable tokens in the tuning dataset. */
+    totalBillableTokenCount?: string;
+    /** Output only. Number of examples in the tuning dataset. */
+    tuningDatasetExampleCount?: string;
+    /** Output only. Number of tuning steps for this Tuning Job. */
+    tuningStepCount?: string;
+    /** Output only. Sample user examples in the training dataset. */
+    userDatasetExamples?: GeminiPreferenceExample[];
+    /** Output only. Dataset distributions for the user input tokens. */
+    userInputTokenDistribution?: DatasetDistribution;
+    /** Output only. Dataset distributions for the user output tokens. */
+    userOutputTokenDistribution?: DatasetDistribution;
+}
+
+/** A pre-tuned model for continuous tuning. */
+export declare interface PreTunedModel {
+    /** Output only. The name of the base model this PreTunedModel was tuned from. */
+    baseModel?: string;
+    /** Optional. The source checkpoint id. If not specified, the default checkpoint will be used. */
+    checkpointId?: string;
+    /** The resource name of the Model. E.g., a model resource name with a specified version id or alias: `projects/{project}/locations/{location}/models/{model}@{version_id}` `projects/{project}/locations/{location}/models/{model}@{alias}` Or, omit the version id to use the default version: `projects/{project}/locations/{location}/models/{model}` */
+    tunedModelName?: string;
+}
+
 /** Config for proactivity features. */
 export declare interface ProactivityConfig {
     /** If enabled, the model can reject responding to the last prompt. For
@@ -5880,6 +6012,12 @@ export declare interface Schema {
 
 export declare type SchemaUnion = Schema | unknown;
 
+/** An image mask representing a brush scribble. */
+export declare interface ScribbleImage {
+    /** The brush scribble to guide segmentation. Valid for the interactive mode. */
+    image?: Image_2;
+}
+
 /** Google search entry point. */
 export declare interface SearchEntryPoint {
     /** Optional. Web content snippet that can be embedded in a web page or an app webview. */
@@ -5901,6 +6039,75 @@ export declare interface Segment {
     text?: string;
 }
 
+/** Configuration for segmenting an image. */
+export declare interface SegmentImageConfig {
+    /** 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 segmentation mode to use. */
+    mode?: SegmentMode;
+    /** The maximum number of predictions to return up to, by top
+     confidence score. */
+    maxPredictions?: number;
+    /** The confidence score threshold for the detections as a decimal
+     value. Only predictions with a confidence score higher than this
+     threshold will be returned. */
+    confidenceThreshold?: number;
+    /** A decimal value representing how much dilation to apply to the
+     masks. 0 for no dilation. 1.0 means the masked area covers the whole
+     image. */
+    maskDilation?: number;
+    /** The binary color threshold to apply to the masks. The threshold
+     can be set to a decimal value between 0 and 255 non-inclusive.
+     Set to -1 for no binary color thresholding. */
+    binaryColorThreshold?: number;
+}
+
+/** The parameters for segmenting an image. */
+export declare interface SegmentImageParameters {
+    /** ID of the model to use. For a list of models, see `Google models
+     <https://cloud.google.com/vertex-ai/generative-ai/docs/learn/models>`_. */
+    model: string;
+    /** A set of source input(s) for image segmentation. */
+    source: SegmentImageSource;
+    /** Configuration for image segmentation. */
+    config?: SegmentImageConfig;
+}
+
+/** The output images response. */
+export declare class SegmentImageResponse {
+    /** List of generated image masks.
+     */
+    generatedMasks?: GeneratedImageMask[];
+}
+
+/** A set of source input(s) for image segmentation. */
+export declare interface SegmentImageSource {
+    /** A text prompt for guiding the model during image segmentation.
+     Required for prompt mode and semantic mode, disallowed for other modes. */
+    prompt?: string;
+    /** The image to be segmented. */
+    image?: Image_2;
+    /** The brush scribble to guide segmentation.
+     Required for the interactive mode, disallowed for other modes. */
+    scribbleImage?: ScribbleImage;
+}
+
+/** Enum that represents the segmentation mode. */
+export declare enum SegmentMode {
+    FOREGROUND = "FOREGROUND",
+    BACKGROUND = "BACKGROUND",
+    PROMPT = "PROMPT",
+    SEMANTIC = "SEMANTIC",
+    INTERACTIVE = "INTERACTIVE"
+}
+
 /** Parameters for sending a message within a chat session.
 
  These parameters are used with the `chat.sendMessage()` method.
@@ -6204,9 +6411,13 @@ export declare enum SubjectReferenceType {
 export declare interface SupervisedHyperParameters {
     /** Optional. Adapter size for tuning. */
     adapterSize?: AdapterSize;
+    /** Optional. Batch size for tuning. This feature is only available for open source models. */
+    batchSize?: string;
     /** 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. Mutually exclusive with `learning_rate`. */
+    /** Optional. Learning rate for tuning. Mutually exclusive with `learning_rate_multiplier`. This feature is only available for open source models. */
+    learningRate?: number;
+    /** Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models. */
     learningRateMultiplier?: number;
 }
 
@@ -6278,6 +6489,8 @@ export declare interface SupervisedTuningSpec {
     hyperParameters?: SupervisedHyperParameters;
     /** Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset. */
     trainingDatasetUri?: string;
+    /** Tuning mode. */
+    tuningMode?: TuningMode;
     /** Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset. */
     validationDatasetUri?: string;
 }
@@ -6437,10 +6650,12 @@ export declare interface Tool {
     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?: ToolComputerUse;
     /** Optional. CodeExecution tool type. Enables the model to execute code as part of generation. */
     codeExecution?: ToolCodeExecution;
-    /** Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations. */
-    computerUse?: ToolComputerUse;
 }
 
 /** 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. */
@@ -6495,7 +6710,7 @@ export declare interface Transcription {
 }
 
 export declare interface TunedModel {
-    /** Output only. The resource name of the TunedModel. Format: `projects/{project}/locations/{location}/models/{model}`. */
+    /** Output only. The resource name of the TunedModel. Format: `projects/{project}/locations/{location}/models/{model}@{version_id}` When tuning from a base model, the version_id will be 1. For continuous tuning, the version id will be incremented by 1 from the last version id in the parent model. E.g., `projects/{project}/locations/{location}/models/{model}@{last_version_id + 1}` */
     model?: string;
     /** Output only. A resource name of an Endpoint. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`. */
     endpoint?: string;
@@ -6546,6 +6761,8 @@ export declare interface TuningDataset {
 export declare interface TuningDataStats {
     /** Output only. Statistics for distillation. */
     distillationDataStats?: DistillationDataStats;
+    /** Output only. Statistics for preference optimization. */
+    preferenceOptimizationDataStats?: PreferenceOptimizationDataStats;
     /** The SFT Tuning data stats. */
     supervisedTuningDataStats?: SupervisedTuningDataStats;
 }
@@ -6581,6 +6798,8 @@ export declare interface TuningJob {
     baseModel?: string;
     /** Output only. The tuned model resources associated with this TuningJob. */
     tunedModel?: TunedModel;
+    /** The pre-tuned model for continuous tuning. */
+    preTunedModel?: PreTunedModel;
     /** Tuning Spec for Supervised Fine Tuning. */
     supervisedTuningSpec?: SupervisedTuningSpec;
     /** Output only. The tuning data statistics associated with this TuningJob. */
@@ -6589,24 +6808,38 @@ export declare interface TuningJob {
     encryptionSpec?: EncryptionSpec;
     /** Tuning Spec for open sourced and third party Partner models. */
     partnerModelTuningSpec?: PartnerModelTuningSpec;
-    /** Tuning Spec for Distillation. */
-    distillationSpec?: DistillationSpec;
+    /** Optional. The user-provided path to custom model weights. Set this field to tune a custom model. The path must be a Cloud Storage directory that contains the model weights in .safetensors format along with associated model metadata files. If this field is set, the base_model field must still be set to indicate which base model the custom model is derived from. This feature is only available for open source models. */
+    customBaseModel?: string;
     /** Output only. The Experiment associated with this TuningJob. */
     experiment?: string;
     /** 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>;
+    /** Optional. Cloud Storage path to the directory where tuning job outputs are written to. This field is only available and required for open source models. */
+    outputUri?: string;
     /** Output only. The resource name of the PipelineJob associated with the TuningJob. Format: `projects/{project}/locations/{location}/pipelineJobs/{pipeline_job}`. */
     pipelineJob?: string;
-    /** Output only. Reserved for future use. */
-    satisfiesPzi?: boolean;
-    /** Output only. Reserved for future use. */
-    satisfiesPzs?: boolean;
     /** The service account that the tuningJob workload runs as. If not specified, the Vertex AI Secure Fine-Tuned Service Agent in the project will be used. See https://cloud.google.com/iam/docs/service-agents#vertex-ai-secure-fine-tuning-service-agent Users starting the pipeline must have the `iam.serviceAccounts.actAs` permission on this service account. */
     serviceAccount?: string;
     /** Optional. The display name of the TunedModel. The name can be up to 128 characters long and can consist of any UTF-8 characters. */
     tunedModelDisplayName?: string;
 }
 
+/** Tuning mode. */
+export declare enum TuningMode {
+    /**
+     * Tuning mode is unspecified.
+     */
+    TUNING_MODE_UNSPECIFIED = "TUNING_MODE_UNSPECIFIED",
+    /**
+     * Full fine-tuning mode.
+     */
+    TUNING_MODE_FULL = "TUNING_MODE_FULL",
+    /**
+     * PEFT adapter tuning mode.
+     */
+    TUNING_MODE_PEFT_ADAPTER = "TUNING_MODE_PEFT_ADAPTER"
+}
+
 /** A long-running operation. */
 export declare interface TuningOperation {
     /** Used to retain the full HTTP response. */
@@ -6739,7 +6972,6 @@ declare namespace types {
         Mode,
         AuthType,
         ApiSpec,
-        Environment,
         UrlRetrievalStatus,
         FinishReason,
         HarmProbability,
@@ -6749,10 +6981,12 @@ declare namespace types {
         Modality,
         MediaResolution,
         JobState,
+        TuningMode,
         AdapterSize,
         FeatureSelectionPreference,
         Behavior,
         DynamicRetrievalConfigMode,
+        Environment,
         FunctionCallingConfigMode,
         SafetyFilterLevel,
         PersonGeneration,
@@ -6761,6 +6995,7 @@ declare namespace types {
         ControlReferenceType,
         SubjectReferenceType,
         EditMode,
+        SegmentMode,
         VideoCompressionQuality,
         FileState,
         FileSource,
@@ -6800,6 +7035,7 @@ declare namespace types {
         AuthConfig,
         GoogleMaps,
         UrlContext,
+        ToolComputerUse,
         ApiAuthApiKeyConfig,
         ApiAuth,
         ExternalApiElasticSearchParams,
@@ -6817,7 +7053,6 @@ declare namespace types {
         VertexRagStore,
         Retrieval,
         ToolCodeExecution,
-        ToolComputerUse,
         Tool,
         FunctionCallingConfig,
         LatLng,
@@ -6842,6 +7077,10 @@ declare namespace types {
         CitationMetadata,
         UrlMetadata,
         UrlContextMetadata,
+        GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution,
+        GroundingChunkMapsPlaceAnswerSourcesReviewSnippet,
+        GroundingChunkMapsPlaceAnswerSources,
+        GroundingChunkMaps,
         RagChunkPageSpan,
         RagChunk,
         GroundingChunkRetrievedContext,
@@ -6887,6 +7126,13 @@ declare namespace types {
         RecontextImageConfig,
         RecontextImageParameters,
         RecontextImageResponse,
+        ScribbleImage,
+        SegmentImageSource,
+        SegmentImageConfig,
+        SegmentImageParameters,
+        EntityLabel,
+        GeneratedImageMask,
+        SegmentImageResponse,
         GetModelConfig,
         GetModelParameters,
         Endpoint,
@@ -6911,6 +7157,7 @@ declare namespace types {
         TokensInfo,
         ComputeTokensResponse,
         Video,
+        VideoGenerationReferenceImage,
         GenerateVideosConfig,
         GenerateVideosParameters,
         GeneratedVideo,
@@ -6920,20 +7167,22 @@ declare namespace types {
         TunedModelCheckpoint,
         TunedModel,
         GoogleRpcStatus,
+        PreTunedModel,
         SupervisedHyperParameters,
         SupervisedTuningSpec,
         DatasetDistributionDistributionBucket,
         DatasetDistribution,
         DatasetStats,
         DistillationDataStats,
+        GeminiPreferenceExampleCompletion,
+        GeminiPreferenceExample,
+        PreferenceOptimizationDataStats,
         SupervisedTuningDatasetDistributionDatasetBucket,
         SupervisedTuningDatasetDistribution,
         SupervisedTuningDataStats,
         TuningDataStats,
         EncryptionSpec,
         PartnerModelTuningSpec,
-        DistillationHyperParameters,
-        DistillationSpec,
         TuningJob,
         ListTuningJobsConfig,
         ListTuningJobsParameters,
@@ -6942,7 +7191,7 @@ declare namespace types {
         TuningDataset,
         TuningValidationDataset,
         CreateTuningJobConfig,
-        CreateTuningJobParameters,
+        CreateTuningJobParametersPrivate,
         TuningOperation,
         CreateCachedContentConfig,
         CreateCachedContentParameters,
@@ -7034,8 +7283,8 @@ declare namespace types {
         ActivityStart,
         ActivityEnd,
         LiveClientRealtimeInput,
-        LiveSendRealtimeInputParameters,
         LiveClientToolResponse,
+        LiveSendRealtimeInputParameters,
         LiveClientMessage,
         LiveConnectConfig,
         LiveConnectParameters,
@@ -7065,6 +7314,7 @@ declare namespace types {
         LiveConnectConstraints,
         CreateAuthTokenConfig,
         CreateAuthTokenParameters,
+        CreateTuningJobParameters,
         BlobImageUnion,
         PartUnion,
         PartListUnion,
@@ -7372,6 +7622,17 @@ export declare enum VideoCompressionQuality {
     LOSSLESS = "LOSSLESS"
 }
 
+/** A reference image for video generation. */
+export declare interface VideoGenerationReferenceImage {
+    /** The reference image.
+     */
+    image?: Image_2;
+    /** The type of the reference image, which defines how the reference
+     image will be used to generate the video. Supported values are 'asset'
+     or 'style'. */
+    referenceType?: string;
+}
+
 /** Describes how the video in the Part should be used by the model. */
 export declare interface VideoMetadata {
     /** The frame rate of the video sent to the model. If not specified, the