@blinkdotnew/sdk 0.17.1 → 0.17.2

package/README.md

@@ -359,7 +359,7 @@ const { object: todoList } = await blink.ai.generateObject({
 const { data } = await blink.ai.generateImage({
   prompt: 'A serene landscape with mountains and a lake at sunset',
   size: '1024x1024',
-  quality: 'hd',
+  quality: 'high',
   n: 2
 })
 console.log('Image URL:', data[0].url)
@@ -368,10 +368,10 @@ console.log('Image URL:', data[0].url)
 const { data: headshots } = await blink.ai.modifyImage({
   images: ['https://storage.example.com/user-photo.jpg'], // ... up to 16 images maximum!
   prompt: 'Generate professional business headshot with studio lighting for this person.',
-  quality: 'hd',
+  quality: 'high',
   n: 4
 })
-// Options: size ('1024x1024', '1536x1024'), quality ('standard'|'hd'), 
+// Options: size ('1024x1024', '1536x1024'), quality ('auto'|'low'|'medium'|'high'), 
 // background ('auto'|'transparent'|'opaque'), n (1-10 images)
 
 

package/dist/index.d.mts

@@ -222,7 +222,7 @@ interface ImageGenerationRequest {
     prompt: string;
     images?: string[];
     size?: string;
-    quality?: 'standard' | 'hd';
+    quality?: 'auto' | 'low' | 'medium' | 'high';
     background?: 'auto' | 'transparent' | 'opaque';
     n?: number;
     response_format?: 'url' | 'b64_json';
@@ -291,7 +291,7 @@ interface BlinkAI {
         images: string[];
         prompt: string;
         size?: string;
-        quality?: "standard" | "hd";
+        quality?: "auto" | "low" | "medium" | "high";
         n?: number;
         background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;
@@ -686,7 +686,7 @@ declare class HttpClient {
         model?: string;
         images?: string[];
         size?: string;
-        quality?: 'standard' | 'hd';
+        quality?: 'auto' | 'low' | 'medium' | 'high';
         background?: 'auto' | 'transparent' | 'opaque';
         n?: number;
         response_format?: 'url' | 'b64_json';
@@ -1452,7 +1452,7 @@ declare class BlinkAIImpl implements BlinkAI {
      * @param options - Object containing:
      *   - `prompt`: Text description of the desired image (required)
      *   - `size`: Image dimensions (default: "1024x1024")
-     *   - `quality`: Image quality ("standard" or "hd", default: "standard")
+     *   - `quality`: Image quality ("auto", "low", "medium", or "high", default: "auto")
      *   - `n`: Number of images to generate (default: 1)
      *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
      *   - Plus optional signal parameter
@@ -1465,21 +1465,21 @@ declare class BlinkAIImpl implements BlinkAI {
      * });
      * console.log("Image URL:", data[0].url);
      *
-     * // High-quality image with specific size
-     * const { data } = await blink.ai.generateImage({
-     *   prompt: "A futuristic city skyline with flying cars",
-     *   size: "1536x1024",
-     *   quality: "hd",
-     *   background: "transparent"
-     * });
+      * // High-quality image with specific size
+   * const { data } = await blink.ai.generateImage({
+   *   prompt: "A futuristic city skyline with flying cars",
+   *   size: "1536x1024",
+   *   quality: "high",
+   *   background: "transparent"
+   * });
      *
-     * // Multiple images
-     * const { data } = await blink.ai.generateImage({
-     *   prompt: "A cute robot mascot for a tech company",
-     *   n: 3,
-     *   size: "1024x1024",
-     *   quality: "hd"
-     * });
+      * // Multiple images
+   * const { data } = await blink.ai.generateImage({
+   *   prompt: "A cute robot mascot for a tech company",
+   *   n: 3,
+   *   size: "1024x1024",
+   *   quality: "high"
+   * });
      * data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url));
      * ```
      *
@@ -1491,7 +1491,7 @@ declare class BlinkAIImpl implements BlinkAI {
     generateImage(options: {
         prompt: string;
         size?: string;
-        quality?: "standard" | "hd";
+        quality?: "auto" | "low" | "medium" | "high";
         n?: number;
         background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;
@@ -1503,7 +1503,7 @@ declare class BlinkAIImpl implements BlinkAI {
      *   - `images`: Array of public image URLs to modify (required, up to 16 images)
      *   - `prompt`: Text description of desired modifications (required)
      *   - `size`: Output image dimensions (default: "auto")
-     *   - `quality`: Image quality ("standard" or "hd", default: "standard")
+     *   - `quality`: Image quality ("auto", "low", "medium", or "high", default: "auto")
      *   - `n`: Number of output images to generate (default: 1)
      *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
      *   - Plus optional signal parameter
@@ -1516,19 +1516,19 @@ declare class BlinkAIImpl implements BlinkAI {
      *     "https://storage.example.com/user-photo-1.jpg",
      *     "https://storage.example.com/user-photo-2.jpg"
      *   ],
-     *   prompt: "Transform into professional business headshots with studio lighting",
-     *   quality: "hd",
-     *   n: 4
+      *   prompt: "Transform into professional business headshots with studio lighting",
+   *   quality: "high",
+   *   n: 4
      * });
      * data.forEach((img, i) => console.log(`Headshot ${i+1}:`, img.url));
      *
      * // Artistic style transformation
-     * const { data } = await blink.ai.modifyImage({
-     *   images: ["https://storage.example.com/portrait.jpg"],
-     *   prompt: "Transform into oil painting style with dramatic lighting",
-     *   quality: "hd",
-     *   size: "1024x1024"
-     * });
+      * const { data } = await blink.ai.modifyImage({
+   *   images: ["https://storage.example.com/portrait.jpg"],
+   *   prompt: "Transform into oil painting style with dramatic lighting",
+   *   quality: "high",
+   *   size: "1024x1024"
+   * });
      *
      * // Background replacement
      * const { data } = await blink.ai.modifyImage({
@@ -1545,9 +1545,9 @@ declare class BlinkAIImpl implements BlinkAI {
      *   "https://storage.example.com/photo3.jpg"
      * ];
      * const { data } = await blink.ai.modifyImage({
-     *   images: userPhotos,
-     *   prompt: "Convert to black and white vintage style photographs",
-     *   quality: "hd"
+      *   images: userPhotos,
+   *   prompt: "Convert to black and white vintage style photographs",
+   *   quality: "high"
      * });
      * ```
      *
@@ -1560,7 +1560,7 @@ declare class BlinkAIImpl implements BlinkAI {
         images: string[];
         prompt: string;
         size?: string;
-        quality?: "standard" | "hd";
+        quality?: "auto" | "low" | "medium" | "high";
         n?: number;
         background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;

package/dist/index.d.ts

@@ -222,7 +222,7 @@ interface ImageGenerationRequest {
     prompt: string;
     images?: string[];
     size?: string;
-    quality?: 'standard' | 'hd';
+    quality?: 'auto' | 'low' | 'medium' | 'high';
     background?: 'auto' | 'transparent' | 'opaque';
     n?: number;
     response_format?: 'url' | 'b64_json';
@@ -291,7 +291,7 @@ interface BlinkAI {
         images: string[];
         prompt: string;
         size?: string;
-        quality?: "standard" | "hd";
+        quality?: "auto" | "low" | "medium" | "high";
         n?: number;
         background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;
@@ -686,7 +686,7 @@ declare class HttpClient {
         model?: string;
         images?: string[];
         size?: string;
-        quality?: 'standard' | 'hd';
+        quality?: 'auto' | 'low' | 'medium' | 'high';
         background?: 'auto' | 'transparent' | 'opaque';
         n?: number;
         response_format?: 'url' | 'b64_json';
@@ -1452,7 +1452,7 @@ declare class BlinkAIImpl implements BlinkAI {
      * @param options - Object containing:
      *   - `prompt`: Text description of the desired image (required)
      *   - `size`: Image dimensions (default: "1024x1024")
-     *   - `quality`: Image quality ("standard" or "hd", default: "standard")
+     *   - `quality`: Image quality ("auto", "low", "medium", or "high", default: "auto")
      *   - `n`: Number of images to generate (default: 1)
      *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
      *   - Plus optional signal parameter
@@ -1465,21 +1465,21 @@ declare class BlinkAIImpl implements BlinkAI {
      * });
      * console.log("Image URL:", data[0].url);
      *
-     * // High-quality image with specific size
-     * const { data } = await blink.ai.generateImage({
-     *   prompt: "A futuristic city skyline with flying cars",
-     *   size: "1536x1024",
-     *   quality: "hd",
-     *   background: "transparent"
-     * });
+      * // High-quality image with specific size
+   * const { data } = await blink.ai.generateImage({
+   *   prompt: "A futuristic city skyline with flying cars",
+   *   size: "1536x1024",
+   *   quality: "high",
+   *   background: "transparent"
+   * });
      *
-     * // Multiple images
-     * const { data } = await blink.ai.generateImage({
-     *   prompt: "A cute robot mascot for a tech company",
-     *   n: 3,
-     *   size: "1024x1024",
-     *   quality: "hd"
-     * });
+      * // Multiple images
+   * const { data } = await blink.ai.generateImage({
+   *   prompt: "A cute robot mascot for a tech company",
+   *   n: 3,
+   *   size: "1024x1024",
+   *   quality: "high"
+   * });
      * data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url));
      * ```
      *
@@ -1491,7 +1491,7 @@ declare class BlinkAIImpl implements BlinkAI {
     generateImage(options: {
         prompt: string;
         size?: string;
-        quality?: "standard" | "hd";
+        quality?: "auto" | "low" | "medium" | "high";
         n?: number;
         background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;
@@ -1503,7 +1503,7 @@ declare class BlinkAIImpl implements BlinkAI {
      *   - `images`: Array of public image URLs to modify (required, up to 16 images)
      *   - `prompt`: Text description of desired modifications (required)
      *   - `size`: Output image dimensions (default: "auto")
-     *   - `quality`: Image quality ("standard" or "hd", default: "standard")
+     *   - `quality`: Image quality ("auto", "low", "medium", or "high", default: "auto")
      *   - `n`: Number of output images to generate (default: 1)
      *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
      *   - Plus optional signal parameter
@@ -1516,19 +1516,19 @@ declare class BlinkAIImpl implements BlinkAI {
      *     "https://storage.example.com/user-photo-1.jpg",
      *     "https://storage.example.com/user-photo-2.jpg"
      *   ],
-     *   prompt: "Transform into professional business headshots with studio lighting",
-     *   quality: "hd",
-     *   n: 4
+      *   prompt: "Transform into professional business headshots with studio lighting",
+   *   quality: "high",
+   *   n: 4
      * });
      * data.forEach((img, i) => console.log(`Headshot ${i+1}:`, img.url));
      *
      * // Artistic style transformation
-     * const { data } = await blink.ai.modifyImage({
-     *   images: ["https://storage.example.com/portrait.jpg"],
-     *   prompt: "Transform into oil painting style with dramatic lighting",
-     *   quality: "hd",
-     *   size: "1024x1024"
-     * });
+      * const { data } = await blink.ai.modifyImage({
+   *   images: ["https://storage.example.com/portrait.jpg"],
+   *   prompt: "Transform into oil painting style with dramatic lighting",
+   *   quality: "high",
+   *   size: "1024x1024"
+   * });
      *
      * // Background replacement
      * const { data } = await blink.ai.modifyImage({
@@ -1545,9 +1545,9 @@ declare class BlinkAIImpl implements BlinkAI {
      *   "https://storage.example.com/photo3.jpg"
      * ];
      * const { data } = await blink.ai.modifyImage({
-     *   images: userPhotos,
-     *   prompt: "Convert to black and white vintage style photographs",
-     *   quality: "hd"
+      *   images: userPhotos,
+   *   prompt: "Convert to black and white vintage style photographs",
+   *   quality: "high"
      * });
      * ```
      *
@@ -1560,7 +1560,7 @@ declare class BlinkAIImpl implements BlinkAI {
         images: string[];
         prompt: string;
         size?: string;
-        quality?: "standard" | "hd";
+        quality?: "auto" | "low" | "medium" | "high";
         n?: number;
         background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;

package/dist/index.js

@@ -2560,47 +2560,47 @@ var BlinkAIImpl = class {
     }
   }
   /**
-   * Generates images from text descriptions using AI.
-   * 
-   * @param options - Object containing:
-   *   - `prompt`: Text description of the desired image (required)
-   *   - `size`: Image dimensions (default: "1024x1024")
-   *   - `quality`: Image quality ("standard" or "hd", default: "standard")
-   *   - `n`: Number of images to generate (default: 1)
-   *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
-   *   - Plus optional signal parameter
-   * 
-   * @example
-   * ```ts
-   * // Basic image generation
-   * const { data } = await blink.ai.generateImage({
-   *   prompt: "A serene landscape with mountains and a lake at sunset"
-   * });
-   * console.log("Image URL:", data[0].url);
-   * 
-   * // High-quality image with specific size
-   * const { data } = await blink.ai.generateImage({
-   *   prompt: "A futuristic city skyline with flying cars",
-   *   size: "1536x1024",
-   *   quality: "hd",
-   *   background: "transparent"
-   * });
-   * 
-   * // Multiple images
-   * const { data } = await blink.ai.generateImage({
-   *   prompt: "A cute robot mascot for a tech company",
-   *   n: 3,
-   *   size: "1024x1024",
-   *   quality: "hd"
-   * });
-   * data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url));
-   * ```
-   * 
-   * @returns Promise<ImageGenerationResponse> - Object containing:
-   *   - `data`: Array of generated images with URLs
-   *   - `created`: Timestamp of generation
-   *   - `usage`: Token usage information
-   */
+    * Generates images from text descriptions using AI.
+    * 
+    * @param options - Object containing:
+    *   - `prompt`: Text description of the desired image (required)
+    *   - `size`: Image dimensions (default: "1024x1024")
+    *   - `quality`: Image quality ("auto", "low", "medium", or "high", default: "auto")
+    *   - `n`: Number of images to generate (default: 1)
+    *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
+    *   - Plus optional signal parameter
+    * 
+    * @example
+    * ```ts
+    * // Basic image generation
+    * const { data } = await blink.ai.generateImage({
+    *   prompt: "A serene landscape with mountains and a lake at sunset"
+    * });
+    * console.log("Image URL:", data[0].url);
+    * 
+     * // High-quality image with specific size
+  * const { data } = await blink.ai.generateImage({
+  *   prompt: "A futuristic city skyline with flying cars",
+  *   size: "1536x1024",
+  *   quality: "high",
+  *   background: "transparent"
+  * });
+    * 
+     * // Multiple images
+  * const { data } = await blink.ai.generateImage({
+  *   prompt: "A cute robot mascot for a tech company",
+  *   n: 3,
+  *   size: "1024x1024",
+  *   quality: "high"
+  * });
+    * data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url));
+    * ```
+    * 
+    * @returns Promise<ImageGenerationResponse> - Object containing:
+    *   - `data`: Array of generated images with URLs
+    *   - `created`: Timestamp of generation
+    *   - `usage`: Token usage information
+    */
   async generateImage(options) {
     try {
       if (!options.prompt) {
@@ -2651,65 +2651,65 @@ var BlinkAIImpl = class {
     }
   }
   /**
-   * Modifies existing images using AI with text prompts for image-to-image editing.
-   * 
-   * @param options - Object containing:
-   *   - `images`: Array of public image URLs to modify (required, up to 16 images)
-   *   - `prompt`: Text description of desired modifications (required)
-   *   - `size`: Output image dimensions (default: "auto")
-   *   - `quality`: Image quality ("standard" or "hd", default: "standard")
-   *   - `n`: Number of output images to generate (default: 1)
-   *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
-   *   - Plus optional signal parameter
-   * 
-   * @example
-   * ```ts
-   * // Professional headshots from casual photos
-   * const { data } = await blink.ai.modifyImage({
-   *   images: [
-   *     "https://storage.example.com/user-photo-1.jpg",
-   *     "https://storage.example.com/user-photo-2.jpg"
-   *   ],
-   *   prompt: "Transform into professional business headshots with studio lighting",
-   *   quality: "hd",
-   *   n: 4
-   * });
-   * data.forEach((img, i) => console.log(`Headshot ${i+1}:`, img.url));
-   * 
-   * // Artistic style transformation
-   * const { data } = await blink.ai.modifyImage({
-   *   images: ["https://storage.example.com/portrait.jpg"],
-   *   prompt: "Transform into oil painting style with dramatic lighting",
-   *   quality: "hd",
-   *   size: "1024x1024"
-   * });
-   * 
-   * // Background replacement
-   * const { data } = await blink.ai.modifyImage({
-   *   images: ["https://storage.example.com/product.jpg"],
-   *   prompt: "Remove background and place on clean white studio background",
-   *   background: "transparent",
-   *   n: 2
-   * });
-   * 
-   * // Batch processing multiple photos
-   * const userPhotos = [
-   *   "https://storage.example.com/photo1.jpg",
-   *   "https://storage.example.com/photo2.jpg",
-   *   "https://storage.example.com/photo3.jpg"
-   * ];
-   * const { data } = await blink.ai.modifyImage({
-   *   images: userPhotos,
-   *   prompt: "Convert to black and white vintage style photographs",
-   *   quality: "hd"
-   * });
-   * ```
-   * 
-   * @returns Promise<ImageGenerationResponse> - Object containing:
-   *   - `data`: Array of modified images with URLs
-   *   - `created`: Timestamp of generation
-   *   - `usage`: Token usage information
-   */
+    * Modifies existing images using AI with text prompts for image-to-image editing.
+    * 
+    * @param options - Object containing:
+    *   - `images`: Array of public image URLs to modify (required, up to 16 images)
+    *   - `prompt`: Text description of desired modifications (required)
+    *   - `size`: Output image dimensions (default: "auto")
+    *   - `quality`: Image quality ("auto", "low", "medium", or "high", default: "auto")
+    *   - `n`: Number of output images to generate (default: 1)
+    *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
+    *   - Plus optional signal parameter
+    * 
+    * @example
+    * ```ts
+    * // Professional headshots from casual photos
+    * const { data } = await blink.ai.modifyImage({
+    *   images: [
+    *     "https://storage.example.com/user-photo-1.jpg",
+    *     "https://storage.example.com/user-photo-2.jpg"
+    *   ],
+     *   prompt: "Transform into professional business headshots with studio lighting",
+  *   quality: "high",
+  *   n: 4
+    * });
+    * data.forEach((img, i) => console.log(`Headshot ${i+1}:`, img.url));
+    * 
+    * // Artistic style transformation
+     * const { data } = await blink.ai.modifyImage({
+  *   images: ["https://storage.example.com/portrait.jpg"],
+  *   prompt: "Transform into oil painting style with dramatic lighting",
+  *   quality: "high",
+  *   size: "1024x1024"
+  * });
+    * 
+    * // Background replacement
+    * const { data } = await blink.ai.modifyImage({
+    *   images: ["https://storage.example.com/product.jpg"],
+    *   prompt: "Remove background and place on clean white studio background",
+    *   background: "transparent",
+    *   n: 2
+    * });
+    * 
+    * // Batch processing multiple photos
+    * const userPhotos = [
+    *   "https://storage.example.com/photo1.jpg",
+    *   "https://storage.example.com/photo2.jpg",
+    *   "https://storage.example.com/photo3.jpg"
+    * ];
+    * const { data } = await blink.ai.modifyImage({
+     *   images: userPhotos,
+  *   prompt: "Convert to black and white vintage style photographs",
+  *   quality: "high"
+    * });
+    * ```
+    * 
+    * @returns Promise<ImageGenerationResponse> - Object containing:
+    *   - `data`: Array of modified images with URLs
+    *   - `created`: Timestamp of generation
+    *   - `usage`: Token usage information
+    */
   async modifyImage(options) {
     try {
       if (!options.prompt) {

package/dist/index.mjs

@@ -2558,47 +2558,47 @@ var BlinkAIImpl = class {
     }
   }
   /**
-   * Generates images from text descriptions using AI.
-   * 
-   * @param options - Object containing:
-   *   - `prompt`: Text description of the desired image (required)
-   *   - `size`: Image dimensions (default: "1024x1024")
-   *   - `quality`: Image quality ("standard" or "hd", default: "standard")
-   *   - `n`: Number of images to generate (default: 1)
-   *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
-   *   - Plus optional signal parameter
-   * 
-   * @example
-   * ```ts
-   * // Basic image generation
-   * const { data } = await blink.ai.generateImage({
-   *   prompt: "A serene landscape with mountains and a lake at sunset"
-   * });
-   * console.log("Image URL:", data[0].url);
-   * 
-   * // High-quality image with specific size
-   * const { data } = await blink.ai.generateImage({
-   *   prompt: "A futuristic city skyline with flying cars",
-   *   size: "1536x1024",
-   *   quality: "hd",
-   *   background: "transparent"
-   * });
-   * 
-   * // Multiple images
-   * const { data } = await blink.ai.generateImage({
-   *   prompt: "A cute robot mascot for a tech company",
-   *   n: 3,
-   *   size: "1024x1024",
-   *   quality: "hd"
-   * });
-   * data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url));
-   * ```
-   * 
-   * @returns Promise<ImageGenerationResponse> - Object containing:
-   *   - `data`: Array of generated images with URLs
-   *   - `created`: Timestamp of generation
-   *   - `usage`: Token usage information
-   */
+    * Generates images from text descriptions using AI.
+    * 
+    * @param options - Object containing:
+    *   - `prompt`: Text description of the desired image (required)
+    *   - `size`: Image dimensions (default: "1024x1024")
+    *   - `quality`: Image quality ("auto", "low", "medium", or "high", default: "auto")
+    *   - `n`: Number of images to generate (default: 1)
+    *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
+    *   - Plus optional signal parameter
+    * 
+    * @example
+    * ```ts
+    * // Basic image generation
+    * const { data } = await blink.ai.generateImage({
+    *   prompt: "A serene landscape with mountains and a lake at sunset"
+    * });
+    * console.log("Image URL:", data[0].url);
+    * 
+     * // High-quality image with specific size
+  * const { data } = await blink.ai.generateImage({
+  *   prompt: "A futuristic city skyline with flying cars",
+  *   size: "1536x1024",
+  *   quality: "high",
+  *   background: "transparent"
+  * });
+    * 
+     * // Multiple images
+  * const { data } = await blink.ai.generateImage({
+  *   prompt: "A cute robot mascot for a tech company",
+  *   n: 3,
+  *   size: "1024x1024",
+  *   quality: "high"
+  * });
+    * data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url));
+    * ```
+    * 
+    * @returns Promise<ImageGenerationResponse> - Object containing:
+    *   - `data`: Array of generated images with URLs
+    *   - `created`: Timestamp of generation
+    *   - `usage`: Token usage information
+    */
   async generateImage(options) {
     try {
       if (!options.prompt) {
@@ -2649,65 +2649,65 @@ var BlinkAIImpl = class {
     }
   }
   /**
-   * Modifies existing images using AI with text prompts for image-to-image editing.
-   * 
-   * @param options - Object containing:
-   *   - `images`: Array of public image URLs to modify (required, up to 16 images)
-   *   - `prompt`: Text description of desired modifications (required)
-   *   - `size`: Output image dimensions (default: "auto")
-   *   - `quality`: Image quality ("standard" or "hd", default: "standard")
-   *   - `n`: Number of output images to generate (default: 1)
-   *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
-   *   - Plus optional signal parameter
-   * 
-   * @example
-   * ```ts
-   * // Professional headshots from casual photos
-   * const { data } = await blink.ai.modifyImage({
-   *   images: [
-   *     "https://storage.example.com/user-photo-1.jpg",
-   *     "https://storage.example.com/user-photo-2.jpg"
-   *   ],
-   *   prompt: "Transform into professional business headshots with studio lighting",
-   *   quality: "hd",
-   *   n: 4
-   * });
-   * data.forEach((img, i) => console.log(`Headshot ${i+1}:`, img.url));
-   * 
-   * // Artistic style transformation
-   * const { data } = await blink.ai.modifyImage({
-   *   images: ["https://storage.example.com/portrait.jpg"],
-   *   prompt: "Transform into oil painting style with dramatic lighting",
-   *   quality: "hd",
-   *   size: "1024x1024"
-   * });
-   * 
-   * // Background replacement
-   * const { data } = await blink.ai.modifyImage({
-   *   images: ["https://storage.example.com/product.jpg"],
-   *   prompt: "Remove background and place on clean white studio background",
-   *   background: "transparent",
-   *   n: 2
-   * });
-   * 
-   * // Batch processing multiple photos
-   * const userPhotos = [
-   *   "https://storage.example.com/photo1.jpg",
-   *   "https://storage.example.com/photo2.jpg",
-   *   "https://storage.example.com/photo3.jpg"
-   * ];
-   * const { data } = await blink.ai.modifyImage({
-   *   images: userPhotos,
-   *   prompt: "Convert to black and white vintage style photographs",
-   *   quality: "hd"
-   * });
-   * ```
-   * 
-   * @returns Promise<ImageGenerationResponse> - Object containing:
-   *   - `data`: Array of modified images with URLs
-   *   - `created`: Timestamp of generation
-   *   - `usage`: Token usage information
-   */
+    * Modifies existing images using AI with text prompts for image-to-image editing.
+    * 
+    * @param options - Object containing:
+    *   - `images`: Array of public image URLs to modify (required, up to 16 images)
+    *   - `prompt`: Text description of desired modifications (required)
+    *   - `size`: Output image dimensions (default: "auto")
+    *   - `quality`: Image quality ("auto", "low", "medium", or "high", default: "auto")
+    *   - `n`: Number of output images to generate (default: 1)
+    *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
+    *   - Plus optional signal parameter
+    * 
+    * @example
+    * ```ts
+    * // Professional headshots from casual photos
+    * const { data } = await blink.ai.modifyImage({
+    *   images: [
+    *     "https://storage.example.com/user-photo-1.jpg",
+    *     "https://storage.example.com/user-photo-2.jpg"
+    *   ],
+     *   prompt: "Transform into professional business headshots with studio lighting",
+  *   quality: "high",
+  *   n: 4
+    * });
+    * data.forEach((img, i) => console.log(`Headshot ${i+1}:`, img.url));
+    * 
+    * // Artistic style transformation
+     * const { data } = await blink.ai.modifyImage({
+  *   images: ["https://storage.example.com/portrait.jpg"],
+  *   prompt: "Transform into oil painting style with dramatic lighting",
+  *   quality: "high",
+  *   size: "1024x1024"
+  * });
+    * 
+    * // Background replacement
+    * const { data } = await blink.ai.modifyImage({
+    *   images: ["https://storage.example.com/product.jpg"],
+    *   prompt: "Remove background and place on clean white studio background",
+    *   background: "transparent",
+    *   n: 2
+    * });
+    * 
+    * // Batch processing multiple photos
+    * const userPhotos = [
+    *   "https://storage.example.com/photo1.jpg",
+    *   "https://storage.example.com/photo2.jpg",
+    *   "https://storage.example.com/photo3.jpg"
+    * ];
+    * const { data } = await blink.ai.modifyImage({
+     *   images: userPhotos,
+  *   prompt: "Convert to black and white vintage style photographs",
+  *   quality: "high"
+    * });
+    * ```
+    * 
+    * @returns Promise<ImageGenerationResponse> - Object containing:
+    *   - `data`: Array of modified images with URLs
+    *   - `created`: Timestamp of generation
+    *   - `usage`: Token usage information
+    */
   async modifyImage(options) {
     try {
       if (!options.prompt) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/sdk",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "Blink TypeScript SDK for client-side applications - Zero-boilerplate CRUD + auth + AI + analytics + notifications for modern SaaS/AI apps",
   "keywords": [
     "blink",