@google/genai 1.15.0 → 1.16.0

package/dist/genai.d.ts

@@ -817,6 +817,27 @@ export declare interface CancelBatchJobParameters {
     config?: CancelBatchJobConfig;
 }
 
+/** Optional parameters for tunings.cancel method. */
+export declare interface CancelTuningJobConfig {
+    /** Used to override HTTP request options. */
+    httpOptions?: HttpOptions;
+    /** Abort signal which can be used to cancel the request.
+
+     NOTE: AbortSignal is a client-only operation. Using it to cancel an
+     operation will not cancel the request in the service. You will still
+     be charged usage for any applicable operations.
+     */
+    abortSignal?: AbortSignal;
+}
+
+/** Parameters for the cancel method. */
+export declare interface CancelTuningJobParameters {
+    /** The resource name of the tuning job. */
+    name: string;
+    /** Optional parameters for the request. */
+    config?: CancelTuningJobConfig;
+}
+
 /** A response candidate generated from the model. */
 export declare interface Candidate {
     /** Contains the multi-part content of the response.
@@ -1561,6 +1582,8 @@ export declare interface DeleteCachedContentParameters {
 
 /** Empty response for caches.delete method. */
 export declare class DeleteCachedContentResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
 }
 
 /** Used to override the default configuration. */
@@ -1586,6 +1609,8 @@ export declare interface DeleteFileParameters {
 
 /** Response for the delete file method. */
 export declare class DeleteFileResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
 }
 
 /** Configuration for deleting a tuned model. */
@@ -1609,6 +1634,8 @@ export declare interface DeleteModelParameters {
 }
 
 export declare class DeleteModelResponse {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
 }
 
 /** The return value of delete operation. */
@@ -2268,7 +2295,11 @@ export declare enum FunctionCallingConfigMode {
     /**
      * Model will not predict any function calls. Model behavior is same as when not passing any function declarations.
      */
-    NONE = "NONE"
+    NONE = "NONE",
+    /**
+     * Model decides to predict either a function call or a natural language response, but will validate function calls with constrained decoding. If "allowed_function_names" are set, the predicted function call will be limited to any one of "allowed_function_names", else the predicted function call will be any one of the provided "function_declarations".
+     */
+    VALIDATED = "VALIDATED"
 }
 
 /** Defines a function that the model can generate JSON inputs for.
@@ -2866,7 +2897,7 @@ export declare interface GenerateVideosConfig {
     compressionQuality?: VideoCompressionQuality;
 }
 
-/** A video generation long-running operation. */
+/** A video generation operation. */
 export declare class GenerateVideosOperation implements Operation<GenerateVideosResponse> {
     /** The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`. */
     name?: string;
@@ -2876,7 +2907,7 @@ export declare class GenerateVideosOperation implements Operation<GenerateVideos
     done?: boolean;
     /** The error result of the operation in case of failure or cancellation. */
     error?: Record<string, unknown>;
-    /** The response if the operation is successful. */
+    /** The generated videos. */
     response?: GenerateVideosResponse;
     /** The full HTTP response. */
     sdkHttpResponse?: HttpResponse;
@@ -2900,6 +2931,8 @@ export declare interface GenerateVideosParameters {
     /** The input video for video extension use cases.
      Optional if prompt or image is provided. */
     video?: Video;
+    /** A set of source input(s) for video generation. */
+    source?: GenerateVideosSource;
     /** Configuration for generating videos. */
     config?: GenerateVideosConfig;
 }
@@ -2914,6 +2947,19 @@ export declare class GenerateVideosResponse {
     raiMediaFilteredReasons?: string[];
 }
 
+/** A set of source input(s) for video generation. */
+export declare interface GenerateVideosSource {
+    /** The text prompt for generating the videos.
+     Optional if image or video is provided. */
+    prompt?: string;
+    /** The input image for generating the videos.
+     Optional if prompt or video is provided. */
+    image?: Image_2;
+    /** The input video for video extension use cases.
+     Optional if prompt or image is provided. */
+    video?: Video;
+}
+
 /** Generation config. */
 export declare interface GenerationConfig {
     /** Optional. Config for model selection. */
@@ -3097,7 +3143,6 @@ export declare interface GetOperationParameters {
     config?: GetOperationConfig;
 }
 
-/** Optional parameters for tunings.get method. */
 export declare interface GetTuningJobConfig {
     /** Used to override HTTP request options. */
     httpOptions?: HttpOptions;
@@ -4652,6 +4697,7 @@ export declare interface LiveServerSessionResumptionUpdate {
     lastConsumedClientMessageIndex?: string;
 }
 
+/** Sent in response to a `LiveGenerateContentSetup` message from the client. */
 export declare interface LiveServerSetupComplete {
     /** The session id of the live session. */
     sessionId?: string;
@@ -5050,7 +5096,9 @@ export declare class Models extends BaseModule {
      * ```ts
      * const operation = await ai.models.generateVideos({
      *  model: 'veo-2.0-generate-001',
-     *  prompt: 'A neon hologram of a cat driving at top speed',
+     *  source: {
+     *    prompt: 'A neon hologram of a cat driving at top speed',
+     *  },
      *  config: {
      *    numberOfVideos: 1
      * });
@@ -5336,10 +5384,10 @@ export declare interface OperationFromAPIResponseParameters {
 
 /** Parameters for the get method of the operations module. */
 export declare interface OperationGetParameters<T, U extends Operation<T>> {
-    /** The operation to be retrieved. */
-    operation: U;
     /** Used to override the default configuration. */
     config?: GetOperationConfig;
+    /** The operation to be retrieved. */
+    operation: U;
 }
 
 export declare class Operations extends BaseModule {
@@ -5738,6 +5786,8 @@ export declare interface RecontextImageConfig {
     /** Whether allow to generate person images, and restrict to specific
      ages. */
     personGeneration?: PersonGeneration;
+    /** Whether to add a SynthID watermark to the generated images. */
+    addWatermark?: boolean;
     /** MIME type of the generated image. */
     outputMimeType?: string;
     /** Compression quality of the generated image (for ``image/jpeg``
@@ -6622,7 +6672,7 @@ export declare class Tokens extends BaseModule {
 
 /** Tokens info with a list of tokens and the corresponding list of token ids. */
 export declare interface TokensInfo {
-    /** Optional. Optional fields for the role from the corresponding Content. */
+    /** Optional fields for the role from the corresponding Content. */
     role?: string;
     /** A list of token ids from the input. */
     tokenIds?: string[];
@@ -6889,6 +6939,18 @@ declare class Tunings extends BaseModule {
     tune: (params: types.CreateTuningJobParameters) => Promise<types.TuningJob>;
     private getInternal;
     private listInternal;
+    /**
+     * Cancels a tuning job.
+     *
+     * @param params - The parameters for the cancel request.
+     * @return The empty response returned by the API.
+     *
+     * @example
+     * ```ts
+     * await ai.tunings.cancel({name: '...'}); // The server-generated resource name.
+     * ```
+     */
+    cancel(params: types.CancelTuningJobParameters): Promise<void>;
     private tuneInternal;
     private tuneMldevInternal;
 }
@@ -6996,6 +7058,7 @@ declare namespace types {
         SubjectReferenceType,
         EditMode,
         SegmentMode,
+        VideoGenerationReferenceType,
         VideoCompressionQuality,
         FileState,
         FileSource,
@@ -7157,11 +7220,14 @@ declare namespace types {
         TokensInfo,
         ComputeTokensResponse,
         Video,
+        GenerateVideosSource,
         VideoGenerationReferenceImage,
         GenerateVideosConfig,
         GenerateVideosParameters,
         GeneratedVideo,
         GenerateVideosResponse,
+        Operation,
+        GenerateVideosOperation,
         GetTuningJobConfig,
         GetTuningJobParameters,
         TunedModelCheckpoint,
@@ -7187,6 +7253,8 @@ declare namespace types {
         ListTuningJobsConfig,
         ListTuningJobsParameters,
         ListTuningJobsResponse,
+        CancelTuningJobConfig,
+        CancelTuningJobParameters,
         TuningExample,
         TuningDataset,
         TuningValidationDataset,
@@ -7267,10 +7335,7 @@ declare namespace types {
         LiveServerGoAway,
         LiveServerSessionResumptionUpdate,
         LiveServerMessage,
-        OperationGetParameters,
         OperationFromAPIResponseParameters,
-        Operation,
-        GenerateVideosOperation,
         AutomaticActivityDetection,
         RealtimeInputConfig,
         SessionResumptionConfig,
@@ -7314,6 +7379,7 @@ declare namespace types {
         LiveConnectConstraints,
         CreateAuthTokenConfig,
         CreateAuthTokenParameters,
+        OperationGetParameters,
         CreateTuningJobParameters,
         BlobImageUnion,
         PartUnion,
@@ -7444,6 +7510,8 @@ export declare interface UpscaleImageConfig {
      be charged usage for any applicable operations.
      */
     abortSignal?: AbortSignal;
+    /** Cloud Storage URI used to store the generated images. */
+    outputGcsUri?: string;
     /** Whether to include a reason for filtered-out images in the
      response. */
     includeRaiReason?: boolean;
@@ -7628,9 +7696,23 @@ export declare interface VideoGenerationReferenceImage {
      */
     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;
+     image will be used to generate the video. */
+    referenceType?: VideoGenerationReferenceType;
+}
+
+/** Enum for the reference type of a video generation reference image. */
+export declare enum VideoGenerationReferenceType {
+    /**
+     * A reference image that provides assets to the generated video,
+     such as the scene, an object, a character, etc.
+     */
+    ASSET = "ASSET",
+    /**
+     * A reference image that provides aesthetics including colors,
+     lighting, texture, etc., to be used as the style of the generated video,
+     such as 'anime', 'photography', 'origami', etc.
+     */
+    STYLE = "STYLE"
 }
 
 /** Describes how the video in the Part should be used by the model. */