@blinkdotnew/dev-sdk 2.1.1 → 2.1.3

package/dist/index.d.mts

@@ -481,6 +481,45 @@ interface TranscriptionRequest {
     response_format?: 'json' | 'text' | 'srt' | 'verbose_json' | 'vtt';
     signal?: AbortSignal;
 }
+interface VideoGenerationRequest {
+    prompt: string;
+    model?: string;
+    image_url?: string;
+    duration?: string;
+    aspect_ratio?: string;
+    resolution?: string;
+    negative_prompt?: string;
+    generate_audio?: boolean;
+    seed?: number;
+    cfg_scale?: number;
+    signal?: AbortSignal;
+}
+interface VideoGenerationResponse {
+    result: {
+        video: {
+            url: string;
+            content_type?: string;
+            file_name?: string;
+            file_size?: number;
+        };
+        seed?: number;
+        video_id?: string;
+        thumbnail?: {
+            url: string;
+        };
+    };
+    metadata?: {
+        projectId: string;
+        timestamp: string;
+        provider: string;
+        model: string;
+    };
+    usage?: {
+        creditsCharged: number;
+        costUSD: number;
+        model: string;
+    };
+}
 interface TranscriptionResponse {
     text: string;
     transcript?: string;
@@ -519,6 +558,7 @@ interface BlinkAI {
         background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
+    generateVideo(options: VideoGenerationRequest): Promise<VideoGenerationResponse>;
     generateSpeech(options: SpeechGenerationRequest): Promise<SpeechGenerationResponse>;
     transcribeAudio(options: TranscriptionRequest): Promise<TranscriptionResponse>;
 }
@@ -984,6 +1024,18 @@ declare class HttpClient {
         response_format?: string;
         signal?: AbortSignal;
     }): Promise<BlinkResponse<any>>;
+    aiVideo(prompt: string, options?: {
+        model?: string;
+        image_url?: string;
+        duration?: string;
+        aspect_ratio?: string;
+        resolution?: string;
+        negative_prompt?: string;
+        generate_audio?: boolean;
+        seed?: number;
+        cfg_scale?: number;
+        signal?: AbortSignal;
+    }): Promise<BlinkResponse<any>>;
     /**
      * Data-specific requests
      */
@@ -2265,6 +2317,82 @@ declare class BlinkAIImpl implements BlinkAI {
         n?: number;
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
+    /**
+     * Generates videos from text prompts or images using AI video generation models.
+     *
+     * @param options - Object containing:
+     *   - `prompt`: Text description of the video to generate (required)
+     *   - `model`: Video model to use (optional). Available models:
+     *       **Text-to-Video Models:**
+     *       - `"fal-ai/veo3.1"` - Google Veo 3.1 (best quality)
+     *       - `"fal-ai/veo3.1/fast"` (default) - Veo 3.1 fast mode (faster, cheaper)
+     *       - `"fal-ai/sora-2/text-to-video/pro"` - OpenAI Sora 2
+     *       - `"fal-ai/kling-video/v2.6/pro/text-to-video"` - Kling 2.6
+     *       **Image-to-Video Models:**
+     *       - `"fal-ai/veo3.1/image-to-video"` - Veo 3.1 I2V
+     *       - `"fal-ai/veo3.1/fast/image-to-video"` - Veo 3.1 fast I2V
+     *       - `"fal-ai/sora-2/image-to-video/pro"` - Sora 2 I2V
+     *       - `"fal-ai/kling-video/v2.6/pro/image-to-video"` - Kling 2.6 I2V
+     *   - `image_url`: Source image URL for image-to-video (required for I2V models)
+     *   - `duration`: Video duration ("4s", "5s", "6s", "8s", "10s", "12s")
+     *   - `aspect_ratio`: Aspect ratio ("16:9", "9:16", "1:1")
+     *   - `resolution`: Resolution ("720p", "1080p") - Veo/Sora only
+     *   - `negative_prompt`: What to avoid in generation - Veo/Kling only
+     *   - `generate_audio`: Generate audio with video (default: true)
+     *   - `seed`: For reproducibility - Veo only
+     *   - `cfg_scale`: Guidance scale (0-1) - Kling only
+     *   - Plus optional signal parameter
+     *
+     * @example
+     * ```ts
+     * // Basic text-to-video generation (uses default fast model)
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A serene sunset over the ocean with gentle waves"
+     * });
+     * console.log("Video URL:", result.video.url);
+     *
+     * // High quality with Veo 3.1
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A cinematic shot of a futuristic city at night",
+     *   model: "fal-ai/veo3.1",
+     *   resolution: "1080p",
+     *   aspect_ratio: "16:9"
+     * });
+     *
+     * // Image-to-video animation
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "Animate this image with gentle camera movement",
+     *   model: "fal-ai/veo3.1/fast/image-to-video",
+     *   image_url: "https://example.com/my-image.jpg",
+     *   duration: "5s"
+     * });
+     *
+     * // Using Sora 2 for creative videos
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A magical forest with glowing fireflies",
+     *   model: "fal-ai/sora-2/text-to-video/pro",
+     *   duration: "8s"
+     * });
+     *
+     * // Using Kling for detailed videos
+     * const { result, usage } = await blink.ai.generateVideo({
+     *   prompt: "A professional cooking tutorial scene",
+     *   model: "fal-ai/kling-video/v2.6/pro/text-to-video",
+     *   negative_prompt: "blur, distort, low quality",
+     *   cfg_scale: 0.7
+     * });
+     * console.log("Credits charged:", usage?.creditsCharged);
+     * ```
+     *
+     * @returns Promise<VideoGenerationResponse> - Object containing:
+     *   - `result.video.url`: URL to the generated video
+     *   - `result.video.content_type`: MIME type (video/mp4)
+     *   - `result.video.file_name`: Generated filename
+     *   - `result.video.file_size`: File size in bytes
+     *   - `metadata`: Generation metadata (projectId, timestamp, model)
+     *   - `usage`: Credits charged and cost information
+     */
+    generateVideo(options: VideoGenerationRequest): Promise<VideoGenerationResponse>;
     /**
      * Converts text to speech using AI voice synthesis models.
      *

package/dist/index.d.ts

@@ -481,6 +481,45 @@ interface TranscriptionRequest {
     response_format?: 'json' | 'text' | 'srt' | 'verbose_json' | 'vtt';
     signal?: AbortSignal;
 }
+interface VideoGenerationRequest {
+    prompt: string;
+    model?: string;
+    image_url?: string;
+    duration?: string;
+    aspect_ratio?: string;
+    resolution?: string;
+    negative_prompt?: string;
+    generate_audio?: boolean;
+    seed?: number;
+    cfg_scale?: number;
+    signal?: AbortSignal;
+}
+interface VideoGenerationResponse {
+    result: {
+        video: {
+            url: string;
+            content_type?: string;
+            file_name?: string;
+            file_size?: number;
+        };
+        seed?: number;
+        video_id?: string;
+        thumbnail?: {
+            url: string;
+        };
+    };
+    metadata?: {
+        projectId: string;
+        timestamp: string;
+        provider: string;
+        model: string;
+    };
+    usage?: {
+        creditsCharged: number;
+        costUSD: number;
+        model: string;
+    };
+}
 interface TranscriptionResponse {
     text: string;
     transcript?: string;
@@ -519,6 +558,7 @@ interface BlinkAI {
         background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
+    generateVideo(options: VideoGenerationRequest): Promise<VideoGenerationResponse>;
     generateSpeech(options: SpeechGenerationRequest): Promise<SpeechGenerationResponse>;
     transcribeAudio(options: TranscriptionRequest): Promise<TranscriptionResponse>;
 }
@@ -984,6 +1024,18 @@ declare class HttpClient {
         response_format?: string;
         signal?: AbortSignal;
     }): Promise<BlinkResponse<any>>;
+    aiVideo(prompt: string, options?: {
+        model?: string;
+        image_url?: string;
+        duration?: string;
+        aspect_ratio?: string;
+        resolution?: string;
+        negative_prompt?: string;
+        generate_audio?: boolean;
+        seed?: number;
+        cfg_scale?: number;
+        signal?: AbortSignal;
+    }): Promise<BlinkResponse<any>>;
     /**
      * Data-specific requests
      */
@@ -2265,6 +2317,82 @@ declare class BlinkAIImpl implements BlinkAI {
         n?: number;
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
+    /**
+     * Generates videos from text prompts or images using AI video generation models.
+     *
+     * @param options - Object containing:
+     *   - `prompt`: Text description of the video to generate (required)
+     *   - `model`: Video model to use (optional). Available models:
+     *       **Text-to-Video Models:**
+     *       - `"fal-ai/veo3.1"` - Google Veo 3.1 (best quality)
+     *       - `"fal-ai/veo3.1/fast"` (default) - Veo 3.1 fast mode (faster, cheaper)
+     *       - `"fal-ai/sora-2/text-to-video/pro"` - OpenAI Sora 2
+     *       - `"fal-ai/kling-video/v2.6/pro/text-to-video"` - Kling 2.6
+     *       **Image-to-Video Models:**
+     *       - `"fal-ai/veo3.1/image-to-video"` - Veo 3.1 I2V
+     *       - `"fal-ai/veo3.1/fast/image-to-video"` - Veo 3.1 fast I2V
+     *       - `"fal-ai/sora-2/image-to-video/pro"` - Sora 2 I2V
+     *       - `"fal-ai/kling-video/v2.6/pro/image-to-video"` - Kling 2.6 I2V
+     *   - `image_url`: Source image URL for image-to-video (required for I2V models)
+     *   - `duration`: Video duration ("4s", "5s", "6s", "8s", "10s", "12s")
+     *   - `aspect_ratio`: Aspect ratio ("16:9", "9:16", "1:1")
+     *   - `resolution`: Resolution ("720p", "1080p") - Veo/Sora only
+     *   - `negative_prompt`: What to avoid in generation - Veo/Kling only
+     *   - `generate_audio`: Generate audio with video (default: true)
+     *   - `seed`: For reproducibility - Veo only
+     *   - `cfg_scale`: Guidance scale (0-1) - Kling only
+     *   - Plus optional signal parameter
+     *
+     * @example
+     * ```ts
+     * // Basic text-to-video generation (uses default fast model)
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A serene sunset over the ocean with gentle waves"
+     * });
+     * console.log("Video URL:", result.video.url);
+     *
+     * // High quality with Veo 3.1
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A cinematic shot of a futuristic city at night",
+     *   model: "fal-ai/veo3.1",
+     *   resolution: "1080p",
+     *   aspect_ratio: "16:9"
+     * });
+     *
+     * // Image-to-video animation
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "Animate this image with gentle camera movement",
+     *   model: "fal-ai/veo3.1/fast/image-to-video",
+     *   image_url: "https://example.com/my-image.jpg",
+     *   duration: "5s"
+     * });
+     *
+     * // Using Sora 2 for creative videos
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A magical forest with glowing fireflies",
+     *   model: "fal-ai/sora-2/text-to-video/pro",
+     *   duration: "8s"
+     * });
+     *
+     * // Using Kling for detailed videos
+     * const { result, usage } = await blink.ai.generateVideo({
+     *   prompt: "A professional cooking tutorial scene",
+     *   model: "fal-ai/kling-video/v2.6/pro/text-to-video",
+     *   negative_prompt: "blur, distort, low quality",
+     *   cfg_scale: 0.7
+     * });
+     * console.log("Credits charged:", usage?.creditsCharged);
+     * ```
+     *
+     * @returns Promise<VideoGenerationResponse> - Object containing:
+     *   - `result.video.url`: URL to the generated video
+     *   - `result.video.content_type`: MIME type (video/mp4)
+     *   - `result.video.file_name`: Generated filename
+     *   - `result.video.file_size`: File size in bytes
+     *   - `metadata`: Generation metadata (projectId, timestamp, model)
+     *   - `usage`: Credits charged and cost information
+     */
+    generateVideo(options: VideoGenerationRequest): Promise<VideoGenerationResponse>;
     /**
      * Converts text to speech using AI voice synthesis models.
      *

package/dist/index.js

@@ -885,6 +885,17 @@ var HttpClient = class {
       signal
     });
   }
+  async aiVideo(prompt, options = {}) {
+    const { signal, ...body } = options;
+    return this.request(`/api/ai/${this.projectId}/video`, {
+      method: "POST",
+      body: {
+        prompt,
+        ...body
+      },
+      signal
+    });
+  }
   /**
    * Data-specific requests
    */
@@ -1274,16 +1285,45 @@ var BlinkAuth = class {
     if (!config.projectId) {
       throw new Error("projectId is required for authentication");
     }
+    const detectAuthUrl = () => {
+      if (typeof window !== "undefined") {
+        const referrer = document.referrer;
+        if (referrer?.includes("dev.blink.new")) {
+          console.log("\u{1F527} Dev environment detected via referrer, using dev.blink.new for auth");
+          return "https://dev.blink.new";
+        }
+        try {
+          if (window.parent !== window) {
+            const parentOrigin = window.parent.location.origin;
+            if (parentOrigin?.includes("dev.blink.new")) {
+              console.log("\u{1F527} Dev environment detected via parent origin, using dev.blink.new for auth");
+              return "https://dev.blink.new";
+            }
+          }
+        } catch {
+        }
+        try {
+          const opener = window.opener?.location?.origin;
+          if (opener?.includes("dev.blink.new")) {
+            console.log("\u{1F527} Dev environment detected via opener, using dev.blink.new for auth");
+            return "https://dev.blink.new";
+          }
+        } catch {
+        }
+      }
+      return "https://blink.new";
+    };
+    const defaultAuthUrl = detectAuthUrl();
     this.authConfig = {
       mode: "managed",
       // Default mode
-      authUrl: "https://blink.new",
+      authUrl: defaultAuthUrl,
       coreUrl: "https://core.blink.new",
       detectSessionInUrl: true,
       // Default to true for web compatibility
       ...config.auth
     };
-    this.authUrl = this.authConfig.authUrl || "https://blink.new";
+    this.authUrl = this.authConfig.authUrl || defaultAuthUrl;
     this.coreUrl = this.authConfig.coreUrl || "https://core.blink.new";
     const hostname = getLocationHostname();
     if (hostname && this.authUrl === "https://blink.new" && (hostname === "localhost" || hostname === "127.0.0.1")) {
@@ -1338,7 +1378,7 @@ var BlinkAuth = class {
   setupParentWindowListener() {
     if (!isWeb || !this.isIframe || !hasWindow()) return;
     window.addEventListener("message", (event) => {
-      if (event.origin !== "https://blink.new" && event.origin !== "http://localhost:3000" && event.origin !== "http://localhost:3001") {
+      if (event.origin !== "https://blink.new" && event.origin !== "https://dev.blink.new" && event.origin !== "http://localhost:3000" && event.origin !== "http://localhost:3001") {
         return;
       }
       if (event.data?.type === "BLINK_AUTH_TOKENS") {
@@ -4311,6 +4351,131 @@ var BlinkAIImpl = class {
       );
     }
   }
+  /**
+   * Generates videos from text prompts or images using AI video generation models.
+   * 
+   * @param options - Object containing:
+   *   - `prompt`: Text description of the video to generate (required)
+   *   - `model`: Video model to use (optional). Available models:
+   *       **Text-to-Video Models:**
+   *       - `"fal-ai/veo3.1"` - Google Veo 3.1 (best quality)
+   *       - `"fal-ai/veo3.1/fast"` (default) - Veo 3.1 fast mode (faster, cheaper)
+   *       - `"fal-ai/sora-2/text-to-video/pro"` - OpenAI Sora 2
+   *       - `"fal-ai/kling-video/v2.6/pro/text-to-video"` - Kling 2.6
+   *       **Image-to-Video Models:**
+   *       - `"fal-ai/veo3.1/image-to-video"` - Veo 3.1 I2V
+   *       - `"fal-ai/veo3.1/fast/image-to-video"` - Veo 3.1 fast I2V
+   *       - `"fal-ai/sora-2/image-to-video/pro"` - Sora 2 I2V
+   *       - `"fal-ai/kling-video/v2.6/pro/image-to-video"` - Kling 2.6 I2V
+   *   - `image_url`: Source image URL for image-to-video (required for I2V models)
+   *   - `duration`: Video duration ("4s", "5s", "6s", "8s", "10s", "12s")
+   *   - `aspect_ratio`: Aspect ratio ("16:9", "9:16", "1:1")
+   *   - `resolution`: Resolution ("720p", "1080p") - Veo/Sora only
+   *   - `negative_prompt`: What to avoid in generation - Veo/Kling only
+   *   - `generate_audio`: Generate audio with video (default: true)
+   *   - `seed`: For reproducibility - Veo only
+   *   - `cfg_scale`: Guidance scale (0-1) - Kling only
+   *   - Plus optional signal parameter
+   * 
+   * @example
+   * ```ts
+   * // Basic text-to-video generation (uses default fast model)
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A serene sunset over the ocean with gentle waves"
+   * });
+   * console.log("Video URL:", result.video.url);
+   * 
+   * // High quality with Veo 3.1
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A cinematic shot of a futuristic city at night",
+   *   model: "fal-ai/veo3.1",
+   *   resolution: "1080p",
+   *   aspect_ratio: "16:9"
+   * });
+   * 
+   * // Image-to-video animation
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "Animate this image with gentle camera movement",
+   *   model: "fal-ai/veo3.1/fast/image-to-video",
+   *   image_url: "https://example.com/my-image.jpg",
+   *   duration: "5s"
+   * });
+   * 
+   * // Using Sora 2 for creative videos
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A magical forest with glowing fireflies",
+   *   model: "fal-ai/sora-2/text-to-video/pro",
+   *   duration: "8s"
+   * });
+   * 
+   * // Using Kling for detailed videos
+   * const { result, usage } = await blink.ai.generateVideo({
+   *   prompt: "A professional cooking tutorial scene",
+   *   model: "fal-ai/kling-video/v2.6/pro/text-to-video",
+   *   negative_prompt: "blur, distort, low quality",
+   *   cfg_scale: 0.7
+   * });
+   * console.log("Credits charged:", usage?.creditsCharged);
+   * ```
+   * 
+   * @returns Promise<VideoGenerationResponse> - Object containing:
+   *   - `result.video.url`: URL to the generated video
+   *   - `result.video.content_type`: MIME type (video/mp4)
+   *   - `result.video.file_name`: Generated filename
+   *   - `result.video.file_size`: File size in bytes
+   *   - `metadata`: Generation metadata (projectId, timestamp, model)
+   *   - `usage`: Credits charged and cost information
+   */
+  async generateVideo(options) {
+    try {
+      if (!options.prompt) {
+        throw new BlinkAIError("Prompt is required");
+      }
+      const i2vModels = [
+        "fal-ai/veo3.1/image-to-video",
+        "fal-ai/veo3.1/fast/image-to-video",
+        "fal-ai/sora-2/image-to-video/pro",
+        "fal-ai/kling-video/v2.6/pro/image-to-video"
+      ];
+      if (options.model && i2vModels.includes(options.model) && !options.image_url) {
+        throw new BlinkAIError("image_url is required for image-to-video models");
+      }
+      if (options.image_url) {
+        const validation = this.validateImageUrl(options.image_url);
+        if (!validation.isValid) {
+          throw new BlinkAIError(`Invalid image_url: ${validation.error}`);
+        }
+      }
+      const response = await this.httpClient.aiVideo(
+        options.prompt,
+        {
+          model: options.model,
+          image_url: options.image_url,
+          duration: options.duration,
+          aspect_ratio: options.aspect_ratio,
+          resolution: options.resolution,
+          negative_prompt: options.negative_prompt,
+          generate_audio: options.generate_audio,
+          seed: options.seed,
+          cfg_scale: options.cfg_scale,
+          signal: options.signal
+        }
+      );
+      if (!response.data?.result?.video?.url) {
+        throw new BlinkAIError("Invalid response format: missing video URL");
+      }
+      return response.data;
+    } catch (error) {
+      if (error instanceof BlinkAIError) {
+        throw error;
+      }
+      throw new BlinkAIError(
+        `Video generation failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        { originalError: error }
+      );
+    }
+  }
   /**
    * Converts text to speech using AI voice synthesis models.
    * 

package/dist/index.mjs

@@ -883,6 +883,17 @@ var HttpClient = class {
       signal
     });
   }
+  async aiVideo(prompt, options = {}) {
+    const { signal, ...body } = options;
+    return this.request(`/api/ai/${this.projectId}/video`, {
+      method: "POST",
+      body: {
+        prompt,
+        ...body
+      },
+      signal
+    });
+  }
   /**
    * Data-specific requests
    */
@@ -1272,16 +1283,45 @@ var BlinkAuth = class {
     if (!config.projectId) {
       throw new Error("projectId is required for authentication");
     }
+    const detectAuthUrl = () => {
+      if (typeof window !== "undefined") {
+        const referrer = document.referrer;
+        if (referrer?.includes("dev.blink.new")) {
+          console.log("\u{1F527} Dev environment detected via referrer, using dev.blink.new for auth");
+          return "https://dev.blink.new";
+        }
+        try {
+          if (window.parent !== window) {
+            const parentOrigin = window.parent.location.origin;
+            if (parentOrigin?.includes("dev.blink.new")) {
+              console.log("\u{1F527} Dev environment detected via parent origin, using dev.blink.new for auth");
+              return "https://dev.blink.new";
+            }
+          }
+        } catch {
+        }
+        try {
+          const opener = window.opener?.location?.origin;
+          if (opener?.includes("dev.blink.new")) {
+            console.log("\u{1F527} Dev environment detected via opener, using dev.blink.new for auth");
+            return "https://dev.blink.new";
+          }
+        } catch {
+        }
+      }
+      return "https://blink.new";
+    };
+    const defaultAuthUrl = detectAuthUrl();
     this.authConfig = {
       mode: "managed",
       // Default mode
-      authUrl: "https://blink.new",
+      authUrl: defaultAuthUrl,
       coreUrl: "https://core.blink.new",
       detectSessionInUrl: true,
       // Default to true for web compatibility
       ...config.auth
     };
-    this.authUrl = this.authConfig.authUrl || "https://blink.new";
+    this.authUrl = this.authConfig.authUrl || defaultAuthUrl;
     this.coreUrl = this.authConfig.coreUrl || "https://core.blink.new";
     const hostname = getLocationHostname();
     if (hostname && this.authUrl === "https://blink.new" && (hostname === "localhost" || hostname === "127.0.0.1")) {
@@ -1336,7 +1376,7 @@ var BlinkAuth = class {
   setupParentWindowListener() {
     if (!isWeb || !this.isIframe || !hasWindow()) return;
     window.addEventListener("message", (event) => {
-      if (event.origin !== "https://blink.new" && event.origin !== "http://localhost:3000" && event.origin !== "http://localhost:3001") {
+      if (event.origin !== "https://blink.new" && event.origin !== "https://dev.blink.new" && event.origin !== "http://localhost:3000" && event.origin !== "http://localhost:3001") {
         return;
       }
       if (event.data?.type === "BLINK_AUTH_TOKENS") {
@@ -4309,6 +4349,131 @@ var BlinkAIImpl = class {
       );
     }
   }
+  /**
+   * Generates videos from text prompts or images using AI video generation models.
+   * 
+   * @param options - Object containing:
+   *   - `prompt`: Text description of the video to generate (required)
+   *   - `model`: Video model to use (optional). Available models:
+   *       **Text-to-Video Models:**
+   *       - `"fal-ai/veo3.1"` - Google Veo 3.1 (best quality)
+   *       - `"fal-ai/veo3.1/fast"` (default) - Veo 3.1 fast mode (faster, cheaper)
+   *       - `"fal-ai/sora-2/text-to-video/pro"` - OpenAI Sora 2
+   *       - `"fal-ai/kling-video/v2.6/pro/text-to-video"` - Kling 2.6
+   *       **Image-to-Video Models:**
+   *       - `"fal-ai/veo3.1/image-to-video"` - Veo 3.1 I2V
+   *       - `"fal-ai/veo3.1/fast/image-to-video"` - Veo 3.1 fast I2V
+   *       - `"fal-ai/sora-2/image-to-video/pro"` - Sora 2 I2V
+   *       - `"fal-ai/kling-video/v2.6/pro/image-to-video"` - Kling 2.6 I2V
+   *   - `image_url`: Source image URL for image-to-video (required for I2V models)
+   *   - `duration`: Video duration ("4s", "5s", "6s", "8s", "10s", "12s")
+   *   - `aspect_ratio`: Aspect ratio ("16:9", "9:16", "1:1")
+   *   - `resolution`: Resolution ("720p", "1080p") - Veo/Sora only
+   *   - `negative_prompt`: What to avoid in generation - Veo/Kling only
+   *   - `generate_audio`: Generate audio with video (default: true)
+   *   - `seed`: For reproducibility - Veo only
+   *   - `cfg_scale`: Guidance scale (0-1) - Kling only
+   *   - Plus optional signal parameter
+   * 
+   * @example
+   * ```ts
+   * // Basic text-to-video generation (uses default fast model)
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A serene sunset over the ocean with gentle waves"
+   * });
+   * console.log("Video URL:", result.video.url);
+   * 
+   * // High quality with Veo 3.1
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A cinematic shot of a futuristic city at night",
+   *   model: "fal-ai/veo3.1",
+   *   resolution: "1080p",
+   *   aspect_ratio: "16:9"
+   * });
+   * 
+   * // Image-to-video animation
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "Animate this image with gentle camera movement",
+   *   model: "fal-ai/veo3.1/fast/image-to-video",
+   *   image_url: "https://example.com/my-image.jpg",
+   *   duration: "5s"
+   * });
+   * 
+   * // Using Sora 2 for creative videos
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A magical forest with glowing fireflies",
+   *   model: "fal-ai/sora-2/text-to-video/pro",
+   *   duration: "8s"
+   * });
+   * 
+   * // Using Kling for detailed videos
+   * const { result, usage } = await blink.ai.generateVideo({
+   *   prompt: "A professional cooking tutorial scene",
+   *   model: "fal-ai/kling-video/v2.6/pro/text-to-video",
+   *   negative_prompt: "blur, distort, low quality",
+   *   cfg_scale: 0.7
+   * });
+   * console.log("Credits charged:", usage?.creditsCharged);
+   * ```
+   * 
+   * @returns Promise<VideoGenerationResponse> - Object containing:
+   *   - `result.video.url`: URL to the generated video
+   *   - `result.video.content_type`: MIME type (video/mp4)
+   *   - `result.video.file_name`: Generated filename
+   *   - `result.video.file_size`: File size in bytes
+   *   - `metadata`: Generation metadata (projectId, timestamp, model)
+   *   - `usage`: Credits charged and cost information
+   */
+  async generateVideo(options) {
+    try {
+      if (!options.prompt) {
+        throw new BlinkAIError("Prompt is required");
+      }
+      const i2vModels = [
+        "fal-ai/veo3.1/image-to-video",
+        "fal-ai/veo3.1/fast/image-to-video",
+        "fal-ai/sora-2/image-to-video/pro",
+        "fal-ai/kling-video/v2.6/pro/image-to-video"
+      ];
+      if (options.model && i2vModels.includes(options.model) && !options.image_url) {
+        throw new BlinkAIError("image_url is required for image-to-video models");
+      }
+      if (options.image_url) {
+        const validation = this.validateImageUrl(options.image_url);
+        if (!validation.isValid) {
+          throw new BlinkAIError(`Invalid image_url: ${validation.error}`);
+        }
+      }
+      const response = await this.httpClient.aiVideo(
+        options.prompt,
+        {
+          model: options.model,
+          image_url: options.image_url,
+          duration: options.duration,
+          aspect_ratio: options.aspect_ratio,
+          resolution: options.resolution,
+          negative_prompt: options.negative_prompt,
+          generate_audio: options.generate_audio,
+          seed: options.seed,
+          cfg_scale: options.cfg_scale,
+          signal: options.signal
+        }
+      );
+      if (!response.data?.result?.video?.url) {
+        throw new BlinkAIError("Invalid response format: missing video URL");
+      }
+      return response.data;
+    } catch (error) {
+      if (error instanceof BlinkAIError) {
+        throw error;
+      }
+      throw new BlinkAIError(
+        `Video generation failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        { originalError: error }
+      );
+    }
+  }
   /**
    * Converts text to speech using AI voice synthesis models.
    * 

package/package.json

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