@google/genai 1.21.0 → 1.22.0

package/dist/genai.d.ts

@@ -1069,6 +1069,18 @@ export declare interface CodeExecutionResult {
     output?: string;
 }
 
+/** Tool to support computer use. */
+export declare interface ComputerUse {
+    /** Required. The environment being operated. */
+    environment?: Environment;
+    /** By default, predefined functions are included in the final model call.
+     Some of them can be explicitly excluded from being automatically included.
+     This can serve two purposes:
+     1. Using a more restricted / different action space.
+     2. Improving the definitions / instructions of predefined functions. */
+    excludedPredefinedFunctions?: string[];
+}
+
 /** Optional parameters for computing tokens. */
 export declare interface ComputeTokensConfig {
     /** Used to override HTTP request options. */
@@ -2344,7 +2356,11 @@ export declare enum FinishReason {
     /**
      * The tool call generated by the model is invalid.
      */
-    UNEXPECTED_TOOL_CALL = "UNEXPECTED_TOOL_CALL"
+    UNEXPECTED_TOOL_CALL = "UNEXPECTED_TOOL_CALL",
+    /**
+     * Image generation stopped because the generated images have prohibited content.
+     */
+    IMAGE_PROHIBITED_CONTENT = "IMAGE_PROHIBITED_CONTENT"
 }
 
 /** A function call. */
@@ -2650,6 +2666,9 @@ export declare interface GenerateContentConfig {
     /** The thinking features configuration.
      */
     thinkingConfig?: ThinkingConfig;
+    /** The image generation configuration.
+     */
+    imageConfig?: ImageConfig;
 }
 
 /** Config for models.generate_content parameters. */
@@ -3771,6 +3790,13 @@ declare interface Image_2 {
 }
 export { Image_2 as Image }
 
+/** The image generation configuration to be used in GenerateContentConfig. */
+export declare interface ImageConfig {
+    /** Aspect ratio of the generated images. Supported values are
+     "1:1", "2:3", "3:2", "3:4", "4:3", "9:16", "16:9", and "21:9". */
+    aspectRatio?: string;
+}
+
 /** Enum that specifies the language of the text in the prompt. */
 export declare enum ImagePromptLanguage {
     /**
@@ -4350,6 +4376,11 @@ export declare interface LiveConnectConfig {
     /** The speech generation configuration.
      */
     speechConfig?: SpeechConfig;
+    /** Config for thinking features.
+     An error will be returned if this field is set for models that don't
+     support thinking.
+     */
+    thinkingConfig?: ThinkingConfig;
     /** If enabled, the model will detect emotions and adapt its responses accordingly. */
     enableAffectiveDialog?: boolean;
     /** The user provided system instructions for the model.
@@ -6815,7 +6846,7 @@ export declare interface Tool {
     /** Optional. Tool to support the model interacting directly with the
      computer. If enabled, it automatically populates computer-use specific
      Function Declarations. */
-    computerUse?: ToolComputerUse;
+    computerUse?: ComputerUse;
     /** Optional. CodeExecution tool type. Enables the model to execute code as part of generation. */
     codeExecution?: ToolCodeExecution;
 }
@@ -6824,18 +6855,6 @@ export declare interface Tool {
 export declare interface ToolCodeExecution {
 }
 
-/** Tool to support computer use. */
-export declare interface ToolComputerUse {
-    /** Required. The environment being operated. */
-    environment?: Environment;
-    /** By default, predefined functions are included in the final model call.
-     Some of them can be explicitly excluded from being automatically included.
-     This can serve two purposes:
-     1. Using a more restricted / different action space.
-     2. Improving the definitions / instructions of predefined functions. */
-    excludedPredefinedFunctions?: string[];
-}
-
 /** Tool config.
 
  This config is shared for all tools provided in the request.
@@ -6990,6 +7009,8 @@ export declare interface TuningJob {
     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 Spec for Veo Tuning. */
+    veoTuningSpec?: VeoTuningSpec;
 }
 
 /** Tuning mode. */
@@ -7073,6 +7094,22 @@ declare class Tunings extends BaseModule {
     private tuneMldevInternal;
 }
 
+/** Optional. The tuning task. Either I2V or T2V. */
+export declare enum TuningTask {
+    /**
+     * Default value. This value is unused.
+     */
+    TUNING_TASK_UNSPECIFIED = "TUNING_TASK_UNSPECIFIED",
+    /**
+     * Tuning task for image to video.
+     */
+    TUNING_TASK_I2V = "TUNING_TASK_I2V",
+    /**
+     * Tuning task for text to video.
+     */
+    TUNING_TASK_T2V = "TUNING_TASK_T2V"
+}
+
 export declare interface TuningValidationDataset {
     /** GCS URI of the file containing validation dataset in JSONL format. */
     gcsUri?: string;
@@ -7183,6 +7220,7 @@ declare namespace types {
         JobState,
         TuningMode,
         AdapterSize,
+        TuningTask,
         FeatureSelectionPreference,
         Behavior,
         DynamicRetrievalConfigMode,
@@ -7241,7 +7279,7 @@ declare namespace types {
         AuthConfig,
         GoogleMaps,
         UrlContext,
-        ToolComputerUse,
+        ComputerUse,
         ApiAuthApiKeyConfig,
         ApiAuth,
         ExternalApiElasticSearchParams,
@@ -7271,6 +7309,7 @@ declare namespace types {
         SpeechConfig,
         AutomaticFunctionCallingConfig,
         ThinkingConfig,
+        ImageConfig,
         GenerationConfigRoutingConfigAutoRoutingMode,
         GenerationConfigRoutingConfigManualRoutingMode,
         GenerationConfigRoutingConfig,
@@ -7393,6 +7432,8 @@ declare namespace types {
         TuningDataStats,
         EncryptionSpec,
         PartnerModelTuningSpec,
+        VeoHyperParameters,
+        VeoTuningSpec,
         TuningJob,
         ListTuningJobsConfig,
         ListTuningJobsParameters,
@@ -7770,6 +7811,26 @@ export declare interface UsageMetadata {
     trafficType?: TrafficType;
 }
 
+/** Hyperparameters for Veo. */
+export declare interface VeoHyperParameters {
+    /** 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;
+    /** Optional. The tuning task. Either I2V or T2V. */
+    tuningTask?: TuningTask;
+}
+
+/** Tuning Spec for Veo Model Tuning. */
+export declare interface VeoTuningSpec {
+    /** Optional. Hyperparameters for Veo. */
+    hyperParameters?: VeoHyperParameters;
+    /** 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;
+    /** 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;
+}
+
 /** Retrieve from Vertex AI Search datastore or engine for grounding. datastore and engine are mutually exclusive. See https://cloud.google.com/products/agent-builder */
 export declare interface VertexAISearch {
     /** Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. It should only be set if engine is used. */