@google/genai 1.16.0 → 1.17.0

package/dist/genai.d.ts

@@ -1720,54 +1720,40 @@ export declare interface EditImageConfig {
      be charged usage for any applicable operations.
      */
     abortSignal?: AbortSignal;
-    /** Cloud Storage URI used to store the generated images.
-     */
+    /** Cloud Storage URI used to store the generated images. */
     outputGcsUri?: string;
-    /** Description of what to discourage in the generated images.
-     */
+    /** Description of what to discourage in the generated images. */
     negativePrompt?: string;
-    /** Number of images to generate.
-     */
+    /** Number of images to generate. */
     numberOfImages?: number;
     /** Aspect ratio of the generated images. Supported values are
-     "1:1", "3:4", "4:3", "9:16", and "16:9".
-     */
+     "1:1", "3:4", "4:3", "9:16", and "16:9". */
     aspectRatio?: string;
     /** Controls how much the model adheres to the text prompt. Large
      values increase output and prompt alignment, but may compromise image
-     quality.
-     */
+     quality. */
     guidanceScale?: number;
     /** Random seed for image generation. This is not available when
-     ``add_watermark`` is set to true.
-     */
+     ``add_watermark`` is set to true. */
     seed?: number;
-    /** Filter level for safety filtering.
-     */
+    /** Filter level for safety filtering. */
     safetyFilterLevel?: SafetyFilterLevel;
-    /** Allows generation of people by the model.
-     */
+    /** Allows generation of people by the model. */
     personGeneration?: PersonGeneration;
     /** Whether to report the safety scores of each generated image and
-     the positive prompt in the response.
-     */
+     the positive prompt in the response. */
     includeSafetyAttributes?: boolean;
     /** Whether to include the Responsible AI filter reason if the image
-     is filtered out of the response.
-     */
+     is filtered out of the response. */
     includeRaiReason?: boolean;
-    /** Language of the text in the prompt.
-     */
+    /** Language of the text in the prompt. */
     language?: ImagePromptLanguage;
-    /** MIME type of the generated image.
-     */
+    /** MIME type of the generated image. */
     outputMimeType?: string;
     /** Compression quality of the generated image (for ``image/jpeg``
-     only).
-     */
+     only). */
     outputCompressionQuality?: number;
-    /** Whether to add a watermark to the generated images.
-     */
+    /** Whether to add a watermark to the generated images. */
     addWatermark?: boolean;
     /** Describes the editing mode for the request. */
     editMode?: EditMode;
@@ -1796,7 +1782,7 @@ export declare class EditImageResponse {
     generatedImages?: GeneratedImage[];
 }
 
-/** Enum representing the Imagen 3 Edit mode. */
+/** Enum representing the editing mode. */
 export declare enum EditMode {
     EDIT_MODE_DEFAULT = "EDIT_MODE_DEFAULT",
     EDIT_MODE_INPAINT_REMOVAL = "EDIT_MODE_INPAINT_REMOVAL",
@@ -2724,20 +2710,16 @@ export declare class GenerateContentResponseUsageMetadata {
 
 /** An output image. */
 export declare interface GeneratedImage {
-    /** The output image data.
-     */
+    /** The output image data. */
     image?: Image_2;
     /** Responsible AI filter reason if the image is filtered out of the
-     response.
-     */
+     response. */
     raiFilteredReason?: string;
     /** Safety attributes of the image. Lists of RAI categories and their
-     scores of each content.
-     */
+     scores of each content. */
     safetyAttributes?: SafetyAttributes;
     /** The rewritten prompt used for the image generation if the prompt
-     enhancer is enabled.
-     */
+     enhancer is enabled. */
     enhancedPrompt?: string;
 }
 
@@ -2766,61 +2748,45 @@ export declare interface GenerateImagesConfig {
      be charged usage for any applicable operations.
      */
     abortSignal?: AbortSignal;
-    /** Cloud Storage URI used to store the generated images.
-     */
+    /** Cloud Storage URI used to store the generated images. */
     outputGcsUri?: string;
-    /** Description of what to discourage in the generated images.
-     */
+    /** Description of what to discourage in the generated images. */
     negativePrompt?: string;
-    /** Number of images to generate.
-     */
+    /** Number of images to generate. */
     numberOfImages?: number;
     /** Aspect ratio of the generated images. Supported values are
-     "1:1", "3:4", "4:3", "9:16", and "16:9".
-     */
+     "1:1", "3:4", "4:3", "9:16", and "16:9". */
     aspectRatio?: string;
     /** Controls how much the model adheres to the text prompt. Large
      values increase output and prompt alignment, but may compromise image
-     quality.
-     */
+     quality. */
     guidanceScale?: number;
     /** Random seed for image generation. This is not available when
-     ``add_watermark`` is set to true.
-     */
+     ``add_watermark`` is set to true. */
     seed?: number;
-    /** Filter level for safety filtering.
-     */
+    /** Filter level for safety filtering. */
     safetyFilterLevel?: SafetyFilterLevel;
-    /** Allows generation of people by the model.
-     */
+    /** Allows generation of people by the model. */
     personGeneration?: PersonGeneration;
     /** Whether to report the safety scores of each generated image and
-     the positive prompt in the response.
-     */
+     the positive prompt in the response. */
     includeSafetyAttributes?: boolean;
     /** Whether to include the Responsible AI filter reason if the image
-     is filtered out of the response.
-     */
+     is filtered out of the response. */
     includeRaiReason?: boolean;
-    /** Language of the text in the prompt.
-     */
+    /** Language of the text in the prompt. */
     language?: ImagePromptLanguage;
-    /** MIME type of the generated image.
-     */
+    /** MIME type of the generated image. */
     outputMimeType?: string;
     /** Compression quality of the generated image (for ``image/jpeg``
-     only).
-     */
+     only). */
     outputCompressionQuality?: number;
-    /** Whether to add a watermark to the generated images.
-     */
+    /** Whether to add a watermark to the generated images. */
     addWatermark?: boolean;
     /** The size of the largest dimension of the generated image.
-     Supported sizes are 1K and 2K (not supported for Imagen 3 models).
-     */
+     Supported sizes are 1K and 2K (not supported for Imagen 3 models). */
     imageSize?: string;
-    /** Whether to use the prompt rewriting logic.
-     */
+    /** Whether to use the prompt rewriting logic. */
     enhancePrompt?: boolean;
 }
 
@@ -2841,12 +2807,10 @@ export declare interface GenerateImagesParameters {
 export declare class GenerateImagesResponse {
     /** Used to retain the full HTTP response. */
     sdkHttpResponse?: HttpResponse;
-    /** List of generated images.
-     */
+    /** List of generated images. */
     generatedImages?: GeneratedImage[];
     /** Safety attributes of the positive prompt. Only populated if
-     ``include_safety_attributes`` is set to True.
-     */
+     ``include_safety_attributes`` is set to True. */
     positivePromptSafetyAttributes?: SafetyAttributes;
 }
 
@@ -2869,23 +2833,32 @@ export declare interface GenerateVideosConfig {
     fps?: number;
     /** Duration of the clip for video generation in seconds. */
     durationSeconds?: number;
-    /** The RNG seed. If RNG seed is exactly same for each request with unchanged inputs, the prediction results will be consistent. Otherwise, a random RNG seed will be used each time to produce a different result. */
+    /** The RNG seed. If RNG seed is exactly same for each request with
+     unchanged inputs, the prediction results will be consistent. Otherwise,
+     a random RNG seed will be used each time to produce a different
+     result. */
     seed?: number;
-    /** The aspect ratio for the generated video. 16:9 (landscape) and 9:16 (portrait) are supported. */
+    /** The aspect ratio for the generated video. 16:9 (landscape) and
+     9:16 (portrait) are supported. */
     aspectRatio?: string;
-    /** The resolution for the generated video. 720p and 1080p are supported. */
+    /** The resolution for the generated video. 720p and 1080p are
+     supported. */
     resolution?: string;
-    /** Whether allow to generate person videos, and restrict to specific ages. Supported values are: dont_allow, allow_adult. */
+    /** Whether allow to generate person videos, and restrict to specific
+     ages. Supported values are: dont_allow, allow_adult. */
     personGeneration?: string;
-    /** The pubsub topic where to publish the video generation progress. */
+    /** The pubsub topic where to publish the video generation
+     progress. */
     pubsubTopic?: string;
-    /** Optional field in addition to the text content. Negative prompts can be explicitly stated here to help generate the video. */
+    /** Explicitly state what should not be included in the generated
+     videos. */
     negativePrompt?: string;
     /** Whether to use the prompt rewriting logic. */
     enhancePrompt?: boolean;
     /** Whether to generate audio along with the video. */
     generateAudio?: boolean;
-    /** Image to use as the last frame of generated videos. Only supported for image to video use cases. */
+    /** 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.
@@ -2923,13 +2896,14 @@ export declare interface GenerateVideosParameters {
     /** 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;
-    /** The text prompt for generating the videos. Optional for image to video use cases. */
+    /** 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. */
+     Optional if prompt is provided. Not allowed if video is provided. */
     image?: Image_2;
     /** The input video for video extension use cases.
-     Optional if prompt or image is provided. */
+     Optional if prompt is provided. Not allowed if image is provided. */
     video?: Video;
     /** A set of source input(s) for video generation. */
     source?: GenerateVideosSource;
@@ -2953,10 +2927,10 @@ export declare interface GenerateVideosSource {
      Optional if image or video is provided. */
     prompt?: string;
     /** The input image for generating the videos.
-     Optional if prompt or video is provided. */
+     Optional if prompt is provided. Not allowed if video is provided. */
     image?: Image_2;
     /** The input video for video extension use cases.
-     Optional if prompt or image is provided. */
+     Optional if prompt is provided. Not allowed if image is provided. */
     video?: Video;
 }
 
@@ -3641,12 +3615,10 @@ export declare class HttpResponse {
 /** An image. */
 declare interface Image_2 {
     /** The Cloud Storage URI of the image. ``Image`` can contain a value
-     for this field or the ``image_bytes`` field but not both.
-     */
+     for this field or the ``image_bytes`` field but not both. */
     gcsUri?: string;
     /** The image bytes data. ``Image`` can contain a value for this field
      or the ``gcs_uri`` field but not both.
-
      * @remarks Encoded as base64 string. */
     imageBytes?: string;
     /** The MIME type of the image. */
@@ -5137,26 +5109,16 @@ export declare class Models extends BaseModule {
      */
     embedContent(params: types.EmbedContentParameters): Promise<types.EmbedContentResponse>;
     /**
-     * Generates an image based on a text description and configuration.
-     *
-     * @param params - The parameters for generating images.
-     * @return The response from the API.
-     *
-     * @example
-     * ```ts
-     * const response = await ai.models.generateImages({
-     *  model: 'imagen-3.0-generate-002',
-     *  prompt: 'Robot holding a red skateboard',
-     *  config: {
-     *    numberOfImages: 1,
-     *    includeRaiReason: true,
-     *  },
-     * });
-     * console.log(response?.generatedImages?.[0]?.image?.imageBytes);
-     * ```
+     * Private method for generating images.
      */
     private generateImagesInternal;
+    /**
+     * Private method for editing an image.
+     */
     private editImageInternal;
+    /**
+     * Private method for upscaling an image.
+     */
     private upscaleImageInternal;
     /**
      * Recontextualizes an image.
@@ -5295,27 +5257,7 @@ export declare class Models extends BaseModule {
      */
     computeTokens(params: types.ComputeTokensParameters): Promise<types.ComputeTokensResponse>;
     /**
-     *  Generates videos based on a text description and configuration.
-     *
-     * @param params - The parameters for generating videos.
-     * @return A Promise<GenerateVideosOperation> which allows you to track the progress and eventually retrieve the generated videos using the operations.get method.
-     *
-     * @example
-     * ```ts
-     * const operation = await ai.models.generateVideos({
-     *  model: 'veo-2.0-generate-001',
-     *  prompt: 'A neon hologram of a cat driving at top speed',
-     *  config: {
-     *    numberOfVideos: 1
-     * });
-     *
-     * while (!operation.done) {
-     *   await new Promise(resolve => setTimeout(resolve, 10000));
-     *   operation = await ai.operations.getVideosOperation({operation: operation});
-     * }
-     *
-     * console.log(operation.response?.generatedVideos?.[0]?.video?.uri);
-     * ```
+     * Private method for generating videos.
      */
     private generateVideosInternal;
 }
@@ -5903,14 +5845,11 @@ export declare interface RetrievalMetadata {
 
 /** Safety attributes of a GeneratedImage or the user-provided prompt. */
 export declare interface SafetyAttributes {
-    /** List of RAI categories.
-     */
+    /** List of RAI categories. */
     categories?: string[];
-    /** List of scores of each categories.
-     */
+    /** List of scores of each categories. */
     scores?: number[];
-    /** Internal use only.
-     */
+    /** Internal use only. */
     contentType?: string;
 }
 
@@ -7517,8 +7456,8 @@ export declare interface UpscaleImageConfig {
     includeRaiReason?: boolean;
     /** The image format that the output should be saved as. */
     outputMimeType?: string;
-    /** The level of compression if the ``output_mime_type`` is
-     ``image/jpeg``. */
+    /** The level of compression. Only applicable if the
+     ``output_mime_type`` is ``image/jpeg``. */
     outputCompressionQuality?: number;
     /** Whether to add an image enhancing step before upscaling.
      It is expected to suppress the noise and JPEG compression artifacts
@@ -7672,7 +7611,7 @@ export declare interface Video {
     /** Video bytes.
      * @remarks Encoded as base64 string. */
     videoBytes?: string;
-    /** Video encoding, for example "video/mp4". */
+    /** Video encoding, for example ``video/mp4``. */
     mimeType?: string;
 }
 
@@ -7692,8 +7631,7 @@ export declare enum VideoCompressionQuality {
 
 /** A reference image for video generation. */
 export declare interface VideoGenerationReferenceImage {
-    /** The reference image.
-     */
+    /** 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. */

package/dist/index.cjs

@@ -861,7 +861,7 @@ exports.SubjectReferenceType = void 0;
     SubjectReferenceType["SUBJECT_TYPE_ANIMAL"] = "SUBJECT_TYPE_ANIMAL";
     SubjectReferenceType["SUBJECT_TYPE_PRODUCT"] = "SUBJECT_TYPE_PRODUCT";
 })(exports.SubjectReferenceType || (exports.SubjectReferenceType = {}));
-/** Enum representing the Imagen 3 Edit mode. */
+/** Enum representing the editing mode. */
 exports.EditMode = void 0;
 (function (EditMode) {
     EditMode["EDIT_MODE_DEFAULT"] = "EDIT_MODE_DEFAULT";
@@ -6617,7 +6617,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.16.0'; // x-release-please-version
+const SDK_VERSION = '1.17.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';
@@ -11193,8 +11193,9 @@ function generateVideosConfigToMldev(fromObject, parentObject) {
     if (parentObject !== undefined && fromAspectRatio != null) {
         setValueByPath(parentObject, ['parameters', 'aspectRatio'], fromAspectRatio);
     }
-    if (getValueByPath(fromObject, ['resolution']) !== undefined) {
-        throw new Error('resolution parameter is not supported in Gemini API.');
+    const fromResolution = getValueByPath(fromObject, ['resolution']);
+    if (parentObject !== undefined && fromResolution != null) {
+        setValueByPath(parentObject, ['parameters', 'resolution'], fromResolution);
     }
     const fromPersonGeneration = getValueByPath(fromObject, [
         'personGeneration',
@@ -15883,23 +15884,7 @@ class Models extends BaseModule {
         }
     }
     /**
-     * Generates an image based on a text description and configuration.
-     *
-     * @param params - The parameters for generating images.
-     * @return The response from the API.
-     *
-     * @example
-     * ```ts
-     * const response = await ai.models.generateImages({
-     *  model: 'imagen-3.0-generate-002',
-     *  prompt: 'Robot holding a red skateboard',
-     *  config: {
-     *    numberOfImages: 1,
-     *    includeRaiReason: true,
-     *  },
-     * });
-     * console.log(response?.generatedImages?.[0]?.image?.imageBytes);
-     * ```
+     * Private method for generating images.
      */
     async generateImagesInternal(params) {
         var _a, _b, _c, _d;
@@ -15971,6 +15956,9 @@ class Models extends BaseModule {
             });
         }
     }
+    /**
+     * Private method for editing an image.
+     */
     async editImageInternal(params) {
         var _a, _b;
         let response;
@@ -16012,6 +16000,9 @@ class Models extends BaseModule {
             throw new Error('This method is only supported by the Vertex AI.');
         }
     }
+    /**
+     * Private method for upscaling an image.
+     */
     async upscaleImageInternal(params) {
         var _a, _b;
         let response;
@@ -16611,27 +16602,7 @@ class Models extends BaseModule {
         }
     }
     /**
-     *  Generates videos based on a text description and configuration.
-     *
-     * @param params - The parameters for generating videos.
-     * @return A Promise<GenerateVideosOperation> which allows you to track the progress and eventually retrieve the generated videos using the operations.get method.
-     *
-     * @example
-     * ```ts
-     * const operation = await ai.models.generateVideos({
-     *  model: 'veo-2.0-generate-001',
-     *  prompt: 'A neon hologram of a cat driving at top speed',
-     *  config: {
-     *    numberOfVideos: 1
-     * });
-     *
-     * while (!operation.done) {
-     *   await new Promise(resolve => setTimeout(resolve, 10000));
-     *   operation = await ai.operations.getVideosOperation({operation: operation});
-     * }
-     *
-     * console.log(operation.response?.generatedVideos?.[0]?.video?.uri);
-     * ```
+     * Private method for generating videos.
      */
     async generateVideosInternal(params) {
         var _a, _b, _c, _d;

package/dist/index.mjs

@@ -859,7 +859,7 @@ var SubjectReferenceType;
     SubjectReferenceType["SUBJECT_TYPE_ANIMAL"] = "SUBJECT_TYPE_ANIMAL";
     SubjectReferenceType["SUBJECT_TYPE_PRODUCT"] = "SUBJECT_TYPE_PRODUCT";
 })(SubjectReferenceType || (SubjectReferenceType = {}));
-/** Enum representing the Imagen 3 Edit mode. */
+/** Enum representing the editing mode. */
 var EditMode;
 (function (EditMode) {
     EditMode["EDIT_MODE_DEFAULT"] = "EDIT_MODE_DEFAULT";
@@ -6615,7 +6615,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.16.0'; // x-release-please-version
+const SDK_VERSION = '1.17.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';
@@ -11191,8 +11191,9 @@ function generateVideosConfigToMldev(fromObject, parentObject) {
     if (parentObject !== undefined && fromAspectRatio != null) {
         setValueByPath(parentObject, ['parameters', 'aspectRatio'], fromAspectRatio);
     }
-    if (getValueByPath(fromObject, ['resolution']) !== undefined) {
-        throw new Error('resolution parameter is not supported in Gemini API.');
+    const fromResolution = getValueByPath(fromObject, ['resolution']);
+    if (parentObject !== undefined && fromResolution != null) {
+        setValueByPath(parentObject, ['parameters', 'resolution'], fromResolution);
     }
     const fromPersonGeneration = getValueByPath(fromObject, [
         'personGeneration',
@@ -15881,23 +15882,7 @@ class Models extends BaseModule {
         }
     }
     /**
-     * Generates an image based on a text description and configuration.
-     *
-     * @param params - The parameters for generating images.
-     * @return The response from the API.
-     *
-     * @example
-     * ```ts
-     * const response = await ai.models.generateImages({
-     *  model: 'imagen-3.0-generate-002',
-     *  prompt: 'Robot holding a red skateboard',
-     *  config: {
-     *    numberOfImages: 1,
-     *    includeRaiReason: true,
-     *  },
-     * });
-     * console.log(response?.generatedImages?.[0]?.image?.imageBytes);
-     * ```
+     * Private method for generating images.
      */
     async generateImagesInternal(params) {
         var _a, _b, _c, _d;
@@ -15969,6 +15954,9 @@ class Models extends BaseModule {
             });
         }
     }
+    /**
+     * Private method for editing an image.
+     */
     async editImageInternal(params) {
         var _a, _b;
         let response;
@@ -16010,6 +15998,9 @@ class Models extends BaseModule {
             throw new Error('This method is only supported by the Vertex AI.');
         }
     }
+    /**
+     * Private method for upscaling an image.
+     */
     async upscaleImageInternal(params) {
         var _a, _b;
         let response;
@@ -16609,27 +16600,7 @@ class Models extends BaseModule {
         }
     }
     /**
-     *  Generates videos based on a text description and configuration.
-     *
-     * @param params - The parameters for generating videos.
-     * @return A Promise<GenerateVideosOperation> which allows you to track the progress and eventually retrieve the generated videos using the operations.get method.
-     *
-     * @example
-     * ```ts
-     * const operation = await ai.models.generateVideos({
-     *  model: 'veo-2.0-generate-001',
-     *  prompt: 'A neon hologram of a cat driving at top speed',
-     *  config: {
-     *    numberOfVideos: 1
-     * });
-     *
-     * while (!operation.done) {
-     *   await new Promise(resolve => setTimeout(resolve, 10000));
-     *   operation = await ai.operations.getVideosOperation({operation: operation});
-     * }
-     *
-     * console.log(operation.response?.generatedVideos?.[0]?.video?.uri);
-     * ```
+     * Private method for generating videos.
      */
     async generateVideosInternal(params) {
         var _a, _b, _c, _d;