@imgly/plugin-ai-video-generation-web 0.2.6 → 0.2.7

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## [Unreleased]
 
+## [0.2.7] - 2025-09-26
+
+### New Features
+
+-   [image-generation] **QwenImageEdit Provider**: Added Qwen image editing provider via fal.ai for advanced image-to-image transformation with text prompts, supporting all standard quick actions
+-   [video-generation] **MinimaxHailuo02StandardImageToVideo Provider**: Added Minimax Hailuo-02 Standard image-to-video provider via fal.ai for transforming still images into videos with selectable resolutions (512P: 912×512, 768P: 1280×720) and adjustable durations (6 or 10 seconds)
+-   [video-generation] **ByteDance Seedance v1 Pro Providers**: Added ByteDance Seedance v1 Pro text-to-video and image-to-video providers via fal.ai with:
+    - Text-to-video generation from text descriptions with customizable aspect ratios
+    - Image-to-video transformation with dynamic motion generation from still images
+    - Multiple aspect ratio options (21:9, 16:9, 4:3, 1:1, 3:4, 9:16, or auto from image for i2v)
+    - Adjustable duration (3-12 seconds, default 5)
+    - Resolution options (480p, 720p, 1080p)
+    - Proper aspect ratio handling in placeholder blocks based on user selection
+
+-   [all] **Property Configuration System**: Providers can now define default values for their properties. Defaults can be static values or dynamic based on context (language, design state, etc.)
+
+-   [image-generation] **Recraft Provider Defaults**: Recraft providers (V3 and 20b) now support configurable default values for all properties, including dynamic style defaults based on the selected style type
+
 ## [0.2.6] - 2025-09-09
 
 ### New Features

package/README.md

@@ -48,6 +48,11 @@ CreativeEditorSDK.create(domElement, {
                 headers: {
                     'x-custom-header': 'value',
                     'x-client-version': '1.0.0'
+                },
+                // Optional: Configure default property values
+                properties: {
+                    duration: 5,  // Default duration in seconds
+                    aspect_ratio: '16:9'  // Default aspect ratio
                 }
             }),
 
@@ -134,6 +139,10 @@ text2video: FalAiVideo.MinimaxVideo01Live({
     headers: {
         'x-custom-header': 'value',
         'x-client-version': '1.0.0'
+    },
+    // Optional: Configure default property values
+    properties: {
+        prompt_optimizer: true  // Enable automatic prompt enhancement
     }
 });
 ```
@@ -165,6 +174,10 @@ image2video: FalAiVideo.MinimaxVideo01LiveImageToVideo({
     headers: {
         'x-custom-header': 'value',
         'x-client-version': '1.0.0'
+    },
+    // Optional: Configure default property values
+    properties: {
+        prompt_optimizer: true  // Enable automatic prompt enhancement
     }
 });
 ```
@@ -176,7 +189,34 @@ Key features:
 -   Maintains original image aspect ratio
 -   Custom headers support for API requests
 
-#### 3. PixverseV35TextToVideo (Text-to-Video)
+#### 3. MinimaxHailuo02StandardImageToVideo (Image-to-Video)
+
+An advanced model that transforms still images into videos using Hailuo 02 Standard:
+
+```typescript
+image2video: FalAiVideo.MinimaxHailuo02StandardImageToVideo({
+    proxyUrl: 'http://your-proxy-server.com/api/proxy',
+    headers: {
+        'x-custom-header': 'value',
+        'x-client-version': '1.0.0'
+    },
+    // Optional: Configure default property values
+    properties: {
+        resolution: '768P',  // Options: '512P' (912×512), '768P' (1280×720)
+        duration: 6          // Duration in seconds (6 or 10)
+    }
+});
+```
+
+Key features:
+
+-   Transform existing images into videos
+-   Available through canvas quick actions
+-   Selectable resolutions (512P: 912×512, 768P: 1280×720)
+-   Adjustable durations (6 or 10 seconds)
+-   Custom headers support for API requests
+
+#### 4. PixverseV35TextToVideo (Text-to-Video)
 
 An alternative text-to-video model:
 
@@ -186,6 +226,10 @@ text2video: FalAiVideo.PixverseV35TextToVideo({
     headers: {
         'x-custom-header': 'value',
         'x-client-version': '1.0.0'
+    },
+    // Optional: Configure default property values
+    properties: {
+        seed: 42  // Fixed seed for reproducible generation
     }
 });
 ```
@@ -195,13 +239,18 @@ Key features:
 -   Alternative text-to-video generation
 -   Custom headers support for API requests
 
-#### 4. KlingVideoV21MasterTextToVideo (Text-to-Video)
+#### 5. KlingVideoV21MasterTextToVideo (Text-to-Video)
 
 A model based on KlingVideo V2.1 that generates videos from text prompts:
 
 ```typescript
 text2video: FalAiVideo.KlingVideoV21MasterTextToVideo({
-    proxyUrl: 'http://your-proxy-server.com/api/proxy'
+    proxyUrl: 'http://your-proxy-server.com/api/proxy',
+    // Optional: Configure default property values
+    properties: {
+        aspect_ratio: '16:9',  // Options: '16:9', '9:16', '1:1'
+        duration: '5s'         // Options: '5s', '10s'
+    }
 });
 ```
 
@@ -224,13 +273,17 @@ cesdk.i18n.setTranslations({
 });
 ```
 
-#### 5. KlingVideoV21MasterImageToVideo (Image-to-Video)
+#### 6. KlingVideoV21MasterImageToVideo (Image-to-Video)
 
 A model that converts still images into videos using KlingVideo V2.1:
 
 ```typescript
 image2video: FalAiVideo.KlingVideoV21MasterImageToVideo({
-    proxyUrl: 'http://your-proxy-server.com/api/proxy'
+    proxyUrl: 'http://your-proxy-server.com/api/proxy',
+    // Optional: Configure default property values
+    properties: {
+        duration: '5s'  // Options: '5s', '10s'
+    }
 });
 ```
 
@@ -241,13 +294,66 @@ Key features:
 -   Canvas quick-action integration
 -   Selectable durations (5 s or 10 s)
 
-#### 6. Veo3TextToVideo (Text-to-Video)
+#### 6. ByteDanceSeedanceV1ProImageToVideo (Image-to-Video)
+
+A model that transforms images into videos using ByteDance Seedance v1 Pro:
+
+```typescript
+image2video: FalAiVideo.ByteDanceSeedanceV1ProImageToVideo({
+    proxyUrl: 'http://your-proxy-server.com/api/proxy',
+    // Optional: Configure default property values
+    properties: {
+        aspect_ratio: 'auto',     // Options: '21:9', '16:9', '4:3', '1:1', '3:4', '9:16', 'auto'
+        duration: 5,              // Duration in seconds (3-12)
+        resolution: '720p'        // Options: '480p', '720p', '1080p'
+    }
+});
+```
+
+Key features:
+
+-   Transform existing images into dynamic videos
+-   Multiple aspect ratio options (21:9, 16:9, 4:3, 1:1, 3:4, 9:16, or auto from image)
+-   Adjustable duration (3-12 seconds, default 5)
+-   Resolution options (480p, 720p, 1080p)
+-   Maintains image quality while adding motion
+
+#### 7. ByteDanceSeedanceV1ProTextToVideo (Text-to-Video)
+
+A model that generates videos from text using ByteDance Seedance v1 Pro:
+
+```typescript
+text2video: FalAiVideo.ByteDanceSeedanceV1ProTextToVideo({
+    proxyUrl: 'http://your-proxy-server.com/api/proxy',
+    // Optional: Configure default property values
+    properties: {
+        aspect_ratio: '16:9',     // Options: '21:9', '16:9', '4:3', '1:1', '3:4', '9:16'
+        duration: 5,              // Duration in seconds (3-12)
+        resolution: '720p'        // Options: '480p', '720p', '1080p'
+    }
+});
+```
+
+Key features:
+
+-   Generate videos from text descriptions
+-   Multiple aspect ratio options (21:9, 16:9, 4:3, 1:1, 3:4, 9:16)
+-   Adjustable duration (3-12 seconds, default 5)
+-   Resolution options (480p, 720p, 1080p)
+-   High-quality motion synthesis from text prompts
+
+#### 8. Veo3TextToVideo (Text-to-Video)
 
 An advanced text-to-video model:
 
 ```typescript
 text2video: FalAiVideo.Veo3TextToVideo({
-    proxyUrl: 'http://your-proxy-server.com/api/proxy'
+    proxyUrl: 'http://your-proxy-server.com/api/proxy',
+    // Optional: Configure default property values
+    properties: {
+        aspect_ratio: '16:9',     // Options: '16:9', '9:16', '1:1'
+        duration: 8               // Fixed at 8 seconds for this provider
+    }
 });
 ```
 
@@ -484,6 +590,16 @@ FalAiVideo.MinimaxVideo01LiveImageToVideo(config: {
 }): AiVideoProvider
 ```
 
+#### MinimaxHailuo02StandardImageToVideo
+
+```typescript
+FalAiVideo.MinimaxHailuo02StandardImageToVideo(config: {
+  proxyUrl: string;
+  headers?: Record<string, string>;
+  debug?: boolean;
+}): AiVideoProvider
+```
+
 #### PixverseV35TextToVideo
 
 ```typescript
@@ -512,6 +628,24 @@ FalAiVideo.KlingVideoV21MasterImageToVideo(config: {
 }): AiVideoProvider
 ```
 
+#### ByteDanceSeedanceV1ProImageToVideo
+
+```typescript
+FalAiVideo.ByteDanceSeedanceV1ProImageToVideo(config: {
+  proxyUrl: string;
+  debug?: boolean;
+}): AiVideoProvider
+```
+
+#### ByteDanceSeedanceV1ProTextToVideo
+
+```typescript
+FalAiVideo.ByteDanceSeedanceV1ProTextToVideo(config: {
+  proxyUrl: string;
+  debug?: boolean;
+}): AiVideoProvider
+```
+
 #### Veo3TextToVideo
 
 ```typescript
@@ -537,9 +671,12 @@ The plugin automatically registers the following UI components:
 -   Provider-specific panels:
     -   MinimaxVideo01Live: `ly.img.ai.fal-ai/minimax/video-01-live`
     -   MinimaxVideo01LiveImageToVideo: `ly.img.ai.fal-ai/minimax/video-01-live/image-to-video`
+    -   MinimaxHailuo02StandardImageToVideo: `ly.img.ai.fal-ai/minimax/hailuo-02/standard/image-to-video`
     -   PixverseV35TextToVideo: `ly.img.ai.fal-ai/pixverse/v3.5/text-to-video`
     -   KlingVideoV21MasterTextToVideo: `ly.img.ai.fal-ai/kling-video/v2.1/master/text-to-video`
     -   KlingVideoV21MasterImageToVideo: `ly.img.ai.fal-ai/kling-video/v2.1/master/image-to-video`
+    -   ByteDanceSeedanceV1ProImageToVideo: `ly.img.ai.fal-ai/bytedance/seedance/v1/pro/image-to-video`
+    -   ByteDanceSeedanceV1ProTextToVideo: `ly.img.ai.fal-ai/bytedance/seedance/v1/pro/text-to-video`
     -   Veo3TextToVideo: `ly.img.ai.fal-ai/veo3`
 
 ### Asset History
@@ -548,9 +685,12 @@ Generated videos are automatically stored in asset sources with the following ID
 
 -   MinimaxVideo01Live: `fal-ai/minimax/video-01-live.history`
 -   MinimaxVideo01LiveImageToVideo: `fal-ai/minimax/video-01-live/image-to-video.history`
+-   MinimaxHailuo02StandardImageToVideo: `fal-ai/minimax/hailuo-02/standard/image-to-video.history`
 -   PixverseV35TextToVideo: `fal-ai/pixverse/v3.5/text-to-video.history`
 -   KlingVideoV21MasterTextToVideo: `fal-ai/kling-video/v2.1/master/text-to-video.history`
 -   KlingVideoV21MasterImageToVideo: `fal-ai/kling-video/v2.1/master/image-to-video.history`
+-   ByteDanceSeedanceV1ProImageToVideo: `fal-ai/bytedance/seedance/v1/pro/image-to-video.history`
+-   ByteDanceSeedanceV1ProTextToVideo: `fal-ai/bytedance/seedance/v1/pro/text-to-video.history`
 -   Veo3TextToVideo: `fal-ai/veo3.history`
 
 ### Dock Integration

package/dist/fal-ai/ByteDanceSeedanceV1ProImageToVideo.d.ts

@@ -0,0 +1,22 @@
+import { VideoOutput, type Provider, CommonProviderConfiguration } from '@imgly/plugin-ai-generation-web';
+import CreativeEditorSDK from '@cesdk/cesdk-js';
+interface ByteDanceSeedanceV1ProImageToVideoInput {
+    prompt: string;
+    image_url: string;
+    aspect_ratio?: '21:9' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16' | 'auto';
+    resolution?: '480p' | '720p' | '1080p';
+    duration?: number;
+    camera_fixed?: boolean;
+    seed?: number;
+    enable_safety_checker?: boolean;
+}
+interface ProviderConfiguration extends CommonProviderConfiguration<ByteDanceSeedanceV1ProImageToVideoInput, VideoOutput> {
+}
+export declare function ByteDanceSeedanceV1ProImageToVideo(config: ProviderConfiguration): (context: {
+    cesdk: CreativeEditorSDK;
+}) => Promise<Provider<'video', ByteDanceSeedanceV1ProImageToVideoInput, VideoOutput>>;
+declare function getProvider(cesdk: CreativeEditorSDK, config: ProviderConfiguration): Provider<'video', ByteDanceSeedanceV1ProImageToVideoInput, {
+    kind: 'video';
+    url: string;
+}>;
+export default getProvider;

package/dist/fal-ai/ByteDanceSeedanceV1ProTextToVideo.d.ts

@@ -0,0 +1,21 @@
+import { VideoOutput, type Provider, CommonProviderConfiguration } from '@imgly/plugin-ai-generation-web';
+import CreativeEditorSDK from '@cesdk/cesdk-js';
+interface ByteDanceSeedanceV1ProTextToVideoInput {
+    prompt: string;
+    aspect_ratio?: '21:9' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16';
+    resolution?: '480p' | '720p' | '1080p';
+    duration?: number;
+    camera_fixed?: boolean;
+    seed?: number;
+    enable_safety_checker?: boolean;
+}
+interface ProviderConfiguration extends CommonProviderConfiguration<ByteDanceSeedanceV1ProTextToVideoInput, VideoOutput> {
+}
+export declare function ByteDanceSeedanceV1ProTextToVideo(config: ProviderConfiguration): (context: {
+    cesdk: CreativeEditorSDK;
+}) => Promise<Provider<'video', ByteDanceSeedanceV1ProTextToVideoInput, VideoOutput>>;
+declare function getProvider(cesdk: CreativeEditorSDK, config: ProviderConfiguration): Provider<'video', ByteDanceSeedanceV1ProTextToVideoInput, {
+    kind: 'video';
+    url: string;
+}>;
+export default getProvider;

package/dist/fal-ai/MinimaxHailuo02StandardImageToVideo.d.ts

@@ -0,0 +1,18 @@
+import { VideoOutput, type Provider, CommonProviderConfiguration } from '@imgly/plugin-ai-generation-web';
+import CreativeEditorSDK from '@cesdk/cesdk-js';
+interface MinimaxHailuo02StandardImageToVideoInput {
+    prompt: string;
+    image_url: string;
+    duration?: '6' | '10';
+    resolution?: '512P' | '768P';
+}
+interface ProviderConfiguration extends CommonProviderConfiguration<MinimaxHailuo02StandardImageToVideoInput, VideoOutput> {
+}
+export declare function MinimaxHailuo02StandardImageToVideo(config: ProviderConfiguration): (context: {
+    cesdk: CreativeEditorSDK;
+}) => Promise<Provider<'video', MinimaxHailuo02StandardImageToVideoInput, VideoOutput>>;
+declare function getProvider(cesdk: CreativeEditorSDK, config: ProviderConfiguration): Provider<'video', MinimaxHailuo02StandardImageToVideoInput, {
+    kind: 'video';
+    url: string;
+}>;
+export default getProvider;

package/dist/fal-ai/index.d.ts

@@ -1,15 +1,21 @@
 import { MinimaxVideo01Live } from './MinimaxVideo01Live';
 import { MinimaxVideo01LiveImageToVideo } from './MinimaxVideo01LiveImageToVideo';
+import { MinimaxHailuo02StandardImageToVideo } from './MinimaxHailuo02StandardImageToVideo';
 import { KlingVideoV21MasterImageToVideo } from './KlingVideoV21MasterImageToVideo';
 import { PixverseV35TextToVideo } from './PixverseV35TextToVideo';
 import { KlingVideoV21MasterTextToVideo } from './KlingVideoV21MasterTextToVideo';
 import { Veo3TextToVideo } from './Veo3TextToVideo';
+import { ByteDanceSeedanceV1ProImageToVideo } from './ByteDanceSeedanceV1ProImageToVideo';
+import { ByteDanceSeedanceV1ProTextToVideo } from './ByteDanceSeedanceV1ProTextToVideo';
 declare const FalAi: {
     MinimaxVideo01Live: typeof MinimaxVideo01Live;
     MinimaxVideo01LiveImageToVideo: typeof MinimaxVideo01LiveImageToVideo;
+    MinimaxHailuo02StandardImageToVideo: typeof MinimaxHailuo02StandardImageToVideo;
     KlingVideoV21MasterImageToVideo: typeof KlingVideoV21MasterImageToVideo;
     PixverseV35TextToVideo: typeof PixverseV35TextToVideo;
     KlingVideoV21MasterTextToVideo: typeof KlingVideoV21MasterTextToVideo;
     Veo3TextToVideo: typeof Veo3TextToVideo;
+    ByteDanceSeedanceV1ProImageToVideo: typeof ByteDanceSeedanceV1ProImageToVideo;
+    ByteDanceSeedanceV1ProTextToVideo: typeof ByteDanceSeedanceV1ProTextToVideo;
 };
 export default FalAi;