@google/genai 1.12.0 → 1.13.0

package/dist/genai.d.ts

@@ -1599,6 +1599,8 @@ export declare class DeleteModelResponse {
 
 /** The return value of delete operation. */
 export declare interface DeleteResourceJob {
+    /** Used to retain the full HTTP response. */
+    sdkHttpResponse?: HttpResponse;
     name?: string;
     done?: boolean;
     error?: JobError;
@@ -2501,9 +2503,6 @@ export declare class GenerateContentResponse {
     /** Timestamp when the request is made to the server.
      */
     createTime?: string;
-    /** Identifier for each response.
-     */
-    responseId?: string;
     /** The history of automatic function calling.
      */
     automaticFunctionCallingHistory?: Content[];
@@ -2511,6 +2510,8 @@ export declare class GenerateContentResponse {
     modelVersion?: string;
     /** Output only. Content filter results for a prompt sent in the request. Note: Sent only in the first stream chunk. Only happens when no candidates were generated due to content violations. */
     promptFeedback?: GenerateContentResponsePromptFeedback;
+    /** Output only. response_id is used to identify each response. It is the encoding of the event_id. */
+    responseId?: string;
     /** Usage metadata about the response(s). */
     usageMetadata?: GenerateContentResponseUsageMetadata;
     /**
@@ -4283,6 +4284,8 @@ export declare interface LiveMusicGenerationConfig {
     muteDrums?: boolean;
     /** Whether the audio output should contain only bass and drums. */
     onlyBassAndDrums?: boolean;
+    /** The mode of music generation. Default mode is QUALITY. */
+    musicGenerationMode?: MusicGenerationMode;
 }
 
 /** The playback control signal to apply to the music generation. */
@@ -5026,6 +5029,45 @@ export declare class Models extends BaseModule {
     private generateImagesInternal;
     private editImageInternal;
     private upscaleImageInternal;
+    /**
+     * Recontextualizes an image.
+     *
+     * There are two types of recontextualization currently supported:
+     * 1) Imagen Product Recontext - Generate images of products in new scenes
+     *    and contexts.
+     * 2) Virtual Try-On: Generate images of persons modeling fashion products.
+     *
+     * @param params - The parameters for recontextualizing an image.
+     * @return The response from the API.
+     *
+     * @example
+     * ```ts
+     * const response1 = await ai.models.recontextImage({
+     *  model: 'imagen-product-recontext-preview-06-30',
+     *  source: {
+     *    prompt: 'In a modern kitchen setting.',
+     *    productImages: [productImage],
+     *  },
+     *  config: {
+     *    numberOfImages: 1,
+     *  },
+     * });
+     * console.log(response1?.generatedImages?.[0]?.image?.imageBytes);
+     *
+     * const response2 = await ai.models.recontextImage({
+     *  model: 'virtual-try-on-preview-08-04',
+     *  source: {
+     *    personImage: personImage,
+     *    productImages: [productImage],
+     *  },
+     *  config: {
+     *    numberOfImages: 1,
+     *  },
+     * });
+     * console.log(response2?.generatedImages?.[0]?.image?.imageBytes);
+     * ```
+     */
+    recontextImage(params: types.RecontextImageParameters): Promise<types.RecontextImageResponse>;
     /**
      * Fetches information about a model by name.
      *
@@ -5140,6 +5182,29 @@ export declare interface MultiSpeakerVoiceConfig {
     speakerVoiceConfigs?: SpeakerVoiceConfig[];
 }
 
+/** The mode of music generation. */
+export declare enum MusicGenerationMode {
+    /**
+     * Rely on the server default generation mode.
+     */
+    MUSIC_GENERATION_MODE_UNSPECIFIED = "MUSIC_GENERATION_MODE_UNSPECIFIED",
+    /**
+     * Steer text prompts to regions of latent space with higher quality
+     music.
+     */
+    QUALITY = "QUALITY",
+    /**
+     * Steer text prompts to regions of latent space with a larger
+     diversity of music.
+     */
+    DIVERSITY = "DIVERSITY",
+    /**
+     * Steer text prompts to regions of latent space more likely to
+     generate music with vocals.
+     */
+    VOCALIZATION = "VOCALIZATION"
+}
+
 /** A long-running operation. */
 export declare interface Operation<T> {
     /** 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}`. */
@@ -5415,6 +5480,12 @@ export declare interface ProactivityConfig {
     proactiveAudio?: boolean;
 }
 
+/** An image of the product. */
+export declare interface ProductImage {
+    /** An image of the product to be recontextualized. */
+    productImage?: Image_2;
+}
+
 /** A RagChunk includes the content of a chunk of a RagFile, and associated metadata. */
 export declare interface RagChunk {
     /** If populated, represents where the chunk starts and ends in the document. */
@@ -5510,6 +5581,69 @@ export declare interface RealtimeInputConfig {
     turnCoverage?: TurnCoverage;
 }
 
+/** Configuration for recontextualizing an image. */
+export declare interface RecontextImageConfig {
+    /** 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;
+    /** Number of images to generate. */
+    numberOfImages?: number;
+    /** The number of sampling steps. A higher value has better image
+     quality, while a lower value has better latency. */
+    baseSteps?: number;
+    /** Cloud Storage URI used to store the generated images. */
+    outputGcsUri?: string;
+    /** Random seed for image generation. */
+    seed?: number;
+    /** Filter level for safety filtering. */
+    safetyFilterLevel?: SafetyFilterLevel;
+    /** Whether allow to generate person images, and restrict to specific
+     ages. */
+    personGeneration?: PersonGeneration;
+    /** MIME type of the generated image. */
+    outputMimeType?: string;
+    /** Compression quality of the generated image (for ``image/jpeg``
+     only). */
+    outputCompressionQuality?: number;
+    /** Whether to use the prompt rewriting logic. */
+    enhancePrompt?: boolean;
+}
+
+/** The parameters for recontextualizing an image. */
+export declare interface RecontextImageParameters {
+    /** 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 recontextualization. */
+    source: RecontextImageSource;
+    /** Configuration for image recontextualization. */
+    config?: RecontextImageConfig;
+}
+
+/** The output images response. */
+export declare class RecontextImageResponse {
+    /** List of generated images. */
+    generatedImages?: GeneratedImage[];
+}
+
+/** A set of source input(s) for image recontextualization. */
+export declare interface RecontextImageSource {
+    /** A text prompt for guiding the model during image
+     recontextualization. Not supported for Virtual Try-On. */
+    prompt?: string;
+    /** Image of the person or subject who will be wearing the
+     product(s). */
+    personImage?: Image_2;
+    /** A list of product images. */
+    productImages?: ProductImage[];
+}
+
 export declare type ReferenceImage = RawReferenceImage | MaskReferenceImage | ControlReferenceImage | StyleReferenceImage | SubjectReferenceImage;
 
 /** Private class that represents a Reference image that is sent to API. */
@@ -6637,6 +6771,7 @@ declare namespace types {
         TurnCoverage,
         FunctionResponseScheduling,
         Scale,
+        MusicGenerationMode,
         LiveMusicPlaybackControl,
         VideoMetadata,
         Blob_2 as Blob,
@@ -6747,6 +6882,11 @@ declare namespace types {
         EditImageConfig,
         EditImageResponse,
         UpscaleImageResponse,
+        ProductImage,
+        RecontextImageSource,
+        RecontextImageConfig,
+        RecontextImageParameters,
+        RecontextImageResponse,
         GetModelConfig,
         GetModelParameters,
         Endpoint,
@@ -7123,7 +7263,15 @@ export declare enum UrlRetrievalStatus {
     /**
      * Url retrieval is failed due to error.
      */
-    URL_RETRIEVAL_STATUS_ERROR = "URL_RETRIEVAL_STATUS_ERROR"
+    URL_RETRIEVAL_STATUS_ERROR = "URL_RETRIEVAL_STATUS_ERROR",
+    /**
+     * Url retrieval is failed because the content is behind paywall.
+     */
+    URL_RETRIEVAL_STATUS_PAYWALL = "URL_RETRIEVAL_STATUS_PAYWALL",
+    /**
+     * Url retrieval is failed because the content is unsafe.
+     */
+    URL_RETRIEVAL_STATUS_UNSAFE = "URL_RETRIEVAL_STATUS_UNSAFE"
 }
 
 /** Usage metadata about response(s). */

package/dist/index.cjs

@@ -416,6 +416,14 @@ exports.UrlRetrievalStatus = void 0;
      * Url retrieval is failed due to error.
      */
     UrlRetrievalStatus["URL_RETRIEVAL_STATUS_ERROR"] = "URL_RETRIEVAL_STATUS_ERROR";
+    /**
+     * Url retrieval is failed because the content is behind paywall.
+     */
+    UrlRetrievalStatus["URL_RETRIEVAL_STATUS_PAYWALL"] = "URL_RETRIEVAL_STATUS_PAYWALL";
+    /**
+     * Url retrieval is failed because the content is unsafe.
+     */
+    UrlRetrievalStatus["URL_RETRIEVAL_STATUS_UNSAFE"] = "URL_RETRIEVAL_STATUS_UNSAFE";
 })(exports.UrlRetrievalStatus || (exports.UrlRetrievalStatus = {}));
 /** Output only. The reason why the model stopped generating tokens.
 
@@ -1042,6 +1050,29 @@ exports.Scale = void 0;
      */
     Scale["B_MAJOR_A_FLAT_MINOR"] = "B_MAJOR_A_FLAT_MINOR";
 })(exports.Scale || (exports.Scale = {}));
+/** The mode of music generation. */
+exports.MusicGenerationMode = void 0;
+(function (MusicGenerationMode) {
+    /**
+     * Rely on the server default generation mode.
+     */
+    MusicGenerationMode["MUSIC_GENERATION_MODE_UNSPECIFIED"] = "MUSIC_GENERATION_MODE_UNSPECIFIED";
+    /**
+     * Steer text prompts to regions of latent space with higher quality
+        music.
+     */
+    MusicGenerationMode["QUALITY"] = "QUALITY";
+    /**
+     * Steer text prompts to regions of latent space with a larger
+        diversity of music.
+     */
+    MusicGenerationMode["DIVERSITY"] = "DIVERSITY";
+    /**
+     * Steer text prompts to regions of latent space more likely to
+        generate music with vocals.
+     */
+    MusicGenerationMode["VOCALIZATION"] = "VOCALIZATION";
+})(exports.MusicGenerationMode || (exports.MusicGenerationMode = {}));
 /** The playback control signal to apply to the music generation. */
 exports.LiveMusicPlaybackControl = void 0;
 (function (LiveMusicPlaybackControl) {
@@ -1465,6 +1496,9 @@ class EditImageResponse {
 }
 class UpscaleImageResponse {
 }
+/** The output images response. */
+class RecontextImageResponse {
+}
 class ListModelsResponse {
 }
 class DeleteModelResponse {
@@ -3670,6 +3704,10 @@ function generateContentResponseFromMldev$1(fromObject) {
     if (fromPromptFeedback != null) {
         setValueByPath(toObject, ['promptFeedback'], fromPromptFeedback);
     }
+    const fromResponseId = getValueByPath(fromObject, ['responseId']);
+    if (fromResponseId != null) {
+        setValueByPath(toObject, ['responseId'], fromResponseId);
+    }
     const fromUsageMetadata = getValueByPath(fromObject, [
         'usageMetadata',
     ]);
@@ -3803,6 +3841,12 @@ function listBatchJobsResponseFromMldev(fromObject) {
 }
 function deleteResourceJobFromMldev(fromObject) {
     const toObject = {};
+    const fromSdkHttpResponse = getValueByPath(fromObject, [
+        'sdkHttpResponse',
+    ]);
+    if (fromSdkHttpResponse != null) {
+        setValueByPath(toObject, ['sdkHttpResponse'], fromSdkHttpResponse);
+    }
     const fromName = getValueByPath(fromObject, ['name']);
     if (fromName != null) {
         setValueByPath(toObject, ['name'], fromName);
@@ -3952,6 +3996,12 @@ function listBatchJobsResponseFromVertex(fromObject) {
 }
 function deleteResourceJobFromVertex(fromObject) {
     const toObject = {};
+    const fromSdkHttpResponse = getValueByPath(fromObject, [
+        'sdkHttpResponse',
+    ]);
+    if (fromSdkHttpResponse != null) {
+        setValueByPath(toObject, ['sdkHttpResponse'], fromSdkHttpResponse);
+    }
     const fromName = getValueByPath(fromObject, ['name']);
     if (fromName != null) {
         setValueByPath(toObject, ['name'], fromName);
@@ -4497,7 +4547,13 @@ class Batches extends BaseModule {
                 abortSignal: (_b = params.config) === null || _b === void 0 ? void 0 : _b.abortSignal,
             })
                 .then((httpResponse) => {
-                return httpResponse.json();
+                return httpResponse.json().then((jsonResponse) => {
+                    const response = jsonResponse;
+                    response.sdkHttpResponse = {
+                        headers: httpResponse.headers,
+                    };
+                    return response;
+                });
             });
             return response.then((apiResponse) => {
                 const resp = deleteResourceJobFromVertex(apiResponse);
@@ -4521,7 +4577,13 @@ class Batches extends BaseModule {
                 abortSignal: (_d = params.config) === null || _d === void 0 ? void 0 : _d.abortSignal,
             })
                 .then((httpResponse) => {
-                return httpResponse.json();
+                return httpResponse.json().then((jsonResponse) => {
+                    const response = jsonResponse;
+                    response.sdkHttpResponse = {
+                        headers: httpResponse.headers,
+                    };
+                    return response;
+                });
             });
             return response.then((apiResponse) => {
                 const resp = deleteResourceJobFromMldev(apiResponse);
@@ -6392,7 +6454,7 @@ const CONTENT_TYPE_HEADER = 'Content-Type';
 const SERVER_TIMEOUT_HEADER = 'X-Server-Timeout';
 const USER_AGENT_HEADER = 'User-Agent';
 const GOOGLE_API_CLIENT_HEADER = 'x-goog-api-client';
-const SDK_VERSION = '1.12.0'; // x-release-please-version
+const SDK_VERSION = '1.13.0'; // x-release-please-version
 const LIBRARY_LABEL = `google-genai-sdk/${SDK_VERSION}`;
 const VERTEX_AI_API_DEFAULT_VERSION = 'v1beta1';
 const GOOGLE_AI_API_DEFAULT_VERSION = 'v1beta';
@@ -8279,6 +8341,12 @@ function liveMusicGenerationConfigToMldev(fromObject) {
     if (fromOnlyBassAndDrums != null) {
         setValueByPath(toObject, ['onlyBassAndDrums'], fromOnlyBassAndDrums);
     }
+    const fromMusicGenerationMode = getValueByPath(fromObject, [
+        'musicGenerationMode',
+    ]);
+    if (fromMusicGenerationMode != null) {
+        setValueByPath(toObject, ['musicGenerationMode'], fromMusicGenerationMode);
+    }
     return toObject;
 }
 function liveMusicSetConfigParametersToMldev(fromObject) {
@@ -9437,6 +9505,12 @@ function liveMusicGenerationConfigFromMldev(fromObject) {
     if (fromOnlyBassAndDrums != null) {
         setValueByPath(toObject, ['onlyBassAndDrums'], fromOnlyBassAndDrums);
     }
+    const fromMusicGenerationMode = getValueByPath(fromObject, [
+        'musicGenerationMode',
+    ]);
+    if (fromMusicGenerationMode != null) {
+        setValueByPath(toObject, ['musicGenerationMode'], fromMusicGenerationMode);
+    }
     return toObject;
 }
 function liveMusicSourceMetadataFromMldev(fromObject) {
@@ -10703,8 +10777,9 @@ function generateImagesConfigToMldev(fromObject, parentObject) {
     if (getValueByPath(fromObject, ['addWatermark']) !== undefined) {
         throw new Error('addWatermark parameter is not supported in Gemini API.');
     }
-    if (getValueByPath(fromObject, ['imageSize']) !== undefined) {
-        throw new Error('imageSize parameter is not supported in Gemini API.');
+    const fromImageSize = getValueByPath(fromObject, ['imageSize']);
+    if (parentObject !== undefined && fromImageSize != null) {
+        setValueByPath(parentObject, ['parameters', 'sampleImageSize'], fromImageSize);
     }
     if (getValueByPath(fromObject, ['enhancePrompt']) !== undefined) {
         throw new Error('enhancePrompt parameter is not supported in Gemini API.');
@@ -12106,6 +12181,106 @@ function upscaleImageAPIParametersInternalToVertex(apiClient, fromObject) {
     }
     return toObject;
 }
+function productImageToVertex(fromObject) {
+    const toObject = {};
+    const fromProductImage = getValueByPath(fromObject, ['productImage']);
+    if (fromProductImage != null) {
+        setValueByPath(toObject, ['image'], imageToVertex(fromProductImage));
+    }
+    return toObject;
+}
+function recontextImageSourceToVertex(fromObject, parentObject) {
+    const toObject = {};
+    const fromPrompt = getValueByPath(fromObject, ['prompt']);
+    if (parentObject !== undefined && fromPrompt != null) {
+        setValueByPath(parentObject, ['instances[0]', 'prompt'], fromPrompt);
+    }
+    const fromPersonImage = getValueByPath(fromObject, ['personImage']);
+    if (parentObject !== undefined && fromPersonImage != null) {
+        setValueByPath(parentObject, ['instances[0]', 'personImage', 'image'], imageToVertex(fromPersonImage));
+    }
+    const fromProductImages = getValueByPath(fromObject, [
+        'productImages',
+    ]);
+    if (parentObject !== undefined && fromProductImages != null) {
+        let transformedList = fromProductImages;
+        if (Array.isArray(transformedList)) {
+            transformedList = transformedList.map((item) => {
+                return productImageToVertex(item);
+            });
+        }
+        setValueByPath(parentObject, ['instances[0]', 'productImages'], transformedList);
+    }
+    return toObject;
+}
+function recontextImageConfigToVertex(fromObject, parentObject) {
+    const toObject = {};
+    const fromNumberOfImages = getValueByPath(fromObject, [
+        'numberOfImages',
+    ]);
+    if (parentObject !== undefined && fromNumberOfImages != null) {
+        setValueByPath(parentObject, ['parameters', 'sampleCount'], fromNumberOfImages);
+    }
+    const fromBaseSteps = getValueByPath(fromObject, ['baseSteps']);
+    if (parentObject !== undefined && fromBaseSteps != null) {
+        setValueByPath(parentObject, ['parameters', 'editConfig', 'baseSteps'], fromBaseSteps);
+    }
+    const fromOutputGcsUri = getValueByPath(fromObject, ['outputGcsUri']);
+    if (parentObject !== undefined && fromOutputGcsUri != null) {
+        setValueByPath(parentObject, ['parameters', 'storageUri'], fromOutputGcsUri);
+    }
+    const fromSeed = getValueByPath(fromObject, ['seed']);
+    if (parentObject !== undefined && fromSeed != null) {
+        setValueByPath(parentObject, ['parameters', 'seed'], fromSeed);
+    }
+    const fromSafetyFilterLevel = getValueByPath(fromObject, [
+        'safetyFilterLevel',
+    ]);
+    if (parentObject !== undefined && fromSafetyFilterLevel != null) {
+        setValueByPath(parentObject, ['parameters', 'safetySetting'], fromSafetyFilterLevel);
+    }
+    const fromPersonGeneration = getValueByPath(fromObject, [
+        'personGeneration',
+    ]);
+    if (parentObject !== undefined && fromPersonGeneration != null) {
+        setValueByPath(parentObject, ['parameters', 'personGeneration'], fromPersonGeneration);
+    }
+    const fromOutputMimeType = getValueByPath(fromObject, [
+        'outputMimeType',
+    ]);
+    if (parentObject !== undefined && fromOutputMimeType != null) {
+        setValueByPath(parentObject, ['parameters', 'outputOptions', 'mimeType'], fromOutputMimeType);
+    }
+    const fromOutputCompressionQuality = getValueByPath(fromObject, [
+        'outputCompressionQuality',
+    ]);
+    if (parentObject !== undefined && fromOutputCompressionQuality != null) {
+        setValueByPath(parentObject, ['parameters', 'outputOptions', 'compressionQuality'], fromOutputCompressionQuality);
+    }
+    const fromEnhancePrompt = getValueByPath(fromObject, [
+        'enhancePrompt',
+    ]);
+    if (parentObject !== undefined && fromEnhancePrompt != null) {
+        setValueByPath(parentObject, ['parameters', 'enhancePrompt'], fromEnhancePrompt);
+    }
+    return toObject;
+}
+function recontextImageParametersToVertex(apiClient, fromObject) {
+    const toObject = {};
+    const fromModel = getValueByPath(fromObject, ['model']);
+    if (fromModel != null) {
+        setValueByPath(toObject, ['_url', 'model'], tModel(apiClient, fromModel));
+    }
+    const fromSource = getValueByPath(fromObject, ['source']);
+    if (fromSource != null) {
+        setValueByPath(toObject, ['config'], recontextImageSourceToVertex(fromSource, toObject));
+    }
+    const fromConfig = getValueByPath(fromObject, ['config']);
+    if (fromConfig != null) {
+        setValueByPath(toObject, ['config'], recontextImageConfigToVertex(fromConfig, toObject));
+    }
+    return toObject;
+}
 function getModelParametersToVertex(apiClient, fromObject) {
     const toObject = {};
     const fromModel = getValueByPath(fromObject, ['model']);
@@ -12602,6 +12777,10 @@ function generateContentResponseFromMldev(fromObject) {
     if (fromPromptFeedback != null) {
         setValueByPath(toObject, ['promptFeedback'], fromPromptFeedback);
     }
+    const fromResponseId = getValueByPath(fromObject, ['responseId']);
+    if (fromResponseId != null) {
+        setValueByPath(toObject, ['responseId'], fromResponseId);
+    }
     const fromUsageMetadata = getValueByPath(fromObject, [
         'usageMetadata',
     ]);
@@ -13152,10 +13331,6 @@ function generateContentResponseFromVertex(fromObject) {
     if (fromCreateTime != null) {
         setValueByPath(toObject, ['createTime'], fromCreateTime);
     }
-    const fromResponseId = getValueByPath(fromObject, ['responseId']);
-    if (fromResponseId != null) {
-        setValueByPath(toObject, ['responseId'], fromResponseId);
-    }
     const fromModelVersion = getValueByPath(fromObject, ['modelVersion']);
     if (fromModelVersion != null) {
         setValueByPath(toObject, ['modelVersion'], fromModelVersion);
@@ -13166,6 +13341,10 @@ function generateContentResponseFromVertex(fromObject) {
     if (fromPromptFeedback != null) {
         setValueByPath(toObject, ['promptFeedback'], fromPromptFeedback);
     }
+    const fromResponseId = getValueByPath(fromObject, ['responseId']);
+    if (fromResponseId != null) {
+        setValueByPath(toObject, ['responseId'], fromResponseId);
+    }
     const fromUsageMetadata = getValueByPath(fromObject, [
         'usageMetadata',
     ]);
@@ -13369,6 +13548,22 @@ function upscaleImageResponseFromVertex(fromObject) {
     }
     return toObject;
 }
+function recontextImageResponseFromVertex(fromObject) {
+    const toObject = {};
+    const fromGeneratedImages = getValueByPath(fromObject, [
+        'predictions',
+    ]);
+    if (fromGeneratedImages != null) {
+        let transformedList = fromGeneratedImages;
+        if (Array.isArray(transformedList)) {
+            transformedList = transformedList.map((item) => {
+                return generatedImageFromVertex(item);
+            });
+        }
+        setValueByPath(toObject, ['generatedImages'], transformedList);
+    }
+    return toObject;
+}
 function endpointFromVertex(fromObject) {
     const toObject = {};
     const fromName = getValueByPath(fromObject, ['endpoint']);
@@ -15412,6 +15607,79 @@ class Models extends BaseModule {
             throw new Error('This method is only supported by the Vertex AI.');
         }
     }
+    /**
+     * Recontextualizes an image.
+     *
+     * There are two types of recontextualization currently supported:
+     * 1) Imagen Product Recontext - Generate images of products in new scenes
+     *    and contexts.
+     * 2) Virtual Try-On: Generate images of persons modeling fashion products.
+     *
+     * @param params - The parameters for recontextualizing an image.
+     * @return The response from the API.
+     *
+     * @example
+     * ```ts
+     * const response1 = await ai.models.recontextImage({
+     *  model: 'imagen-product-recontext-preview-06-30',
+     *  source: {
+     *    prompt: 'In a modern kitchen setting.',
+     *    productImages: [productImage],
+     *  },
+     *  config: {
+     *    numberOfImages: 1,
+     *  },
+     * });
+     * console.log(response1?.generatedImages?.[0]?.image?.imageBytes);
+     *
+     * const response2 = await ai.models.recontextImage({
+     *  model: 'virtual-try-on-preview-08-04',
+     *  source: {
+     *    personImage: personImage,
+     *    productImages: [productImage],
+     *  },
+     *  config: {
+     *    numberOfImages: 1,
+     *  },
+     * });
+     * console.log(response2?.generatedImages?.[0]?.image?.imageBytes);
+     * ```
+     */
+    async recontextImage(params) {
+        var _a, _b;
+        let response;
+        let path = '';
+        let queryParams = {};
+        if (this.apiClient.isVertexAI()) {
+            const body = recontextImageParametersToVertex(this.apiClient, params);
+            path = formatMap('{model}:predict', body['_url']);
+            queryParams = body['_query'];
+            delete body['config'];
+            delete body['_url'];
+            delete body['_query'];
+            response = this.apiClient
+                .request({
+                path: path,
+                queryParams: queryParams,
+                body: JSON.stringify(body),
+                httpMethod: 'POST',
+                httpOptions: (_a = params.config) === null || _a === void 0 ? void 0 : _a.httpOptions,
+                abortSignal: (_b = params.config) === null || _b === void 0 ? void 0 : _b.abortSignal,
+            })
+                .then((httpResponse) => {
+                return httpResponse.json();
+            });
+            return response.then((apiResponse) => {
+                const resp = recontextImageResponseFromVertex(apiResponse);
+                const typedResp = new RecontextImageResponse();
+                Object.assign(typedResp, resp);
+                return typedResp;
+            });
+        }
+        else {
+            throw new Error('This method is only supported by the Vertex AI.');
+        }
+    }
     /**
      * Fetches information about a model by name.
      *
@@ -18005,6 +18273,7 @@ exports.Models = Models;
 exports.Operations = Operations;
 exports.Pager = Pager;
 exports.RawReferenceImage = RawReferenceImage;
+exports.RecontextImageResponse = RecontextImageResponse;
 exports.ReplayResponse = ReplayResponse;
 exports.Session = Session;
 exports.StyleReferenceImage = StyleReferenceImage;