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

package/CHANGELOG.md

@@ -2,12 +2,40 @@
 
 ## [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
+
+-   [all] **Feature API Integration**: Added comprehensive Feature API support across all AI plugins to control visibility and availability of features through feature flags. Core features include `providerSelect`, `quickAction`, `quickAction.providerSelect`, `fromText`, and `fromImage` flags.
+-   [all] **Quick Action Feature Flags**: Each quick action now automatically registers and respects its own feature flag (e.g., `ly.img.plugin-ai-image-generation-web.quickAction.editImage`), allowing fine-grained control over which quick actions are available to users.
+-   [image-generation] **Provider Style Group Control**: Added Feature API support for Recraft providers to control style group visibility. RecraftV3 supports `style.image` and `style.vector` flags, while Recraft20b adds `style.icon` flag for controlling icon style availability.
+-   [all] **Provider Selection Feature Flags**: Added support for controlling provider selection UI in both panels (`providerSelect`) and quick actions (`quickAction.providerSelect`), with proper handling when multiple providers are configured.
+
 ## [0.2.5] - 2025-09-03
 
 ### New Features
 
 -   [image-generation] **NanoBanana Provider**: Added NanoBanana text-to-image provider via fal.ai with fast generation times, 1024×1024 resolution, support for multiple output formats (JPEG, PNG), configurable number of images (1-4), and remixPageWithPrompt quick action
 -   [image-generation] **NanoBananaEdit Provider**: Added NanoBananaEdit image-to-image provider via fal.ai for editing existing images with text prompts, supporting all standard quick actions (editImage, swapBackground, styleTransfer, artistTransfer, createVariant, combineImages with up to 10 images, remixPage, remixPageWithPrompt)
+-   [all] **AI Style Asset Library Translations**: AI style presets in asset libraries now automatically use localized names and descriptions from provider translation files, eliminating the need for manual translation configuration
 
 ### Bug Fixes
 

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
+    }
 });
 ```
 
@@ -258,6 +364,26 @@ Key features:
 -   Fixed duration of 8 seconds
 -   Optional audio generation via `generate_audio`
 
+### Feature Control
+
+You can control various aspects of the video generation plugin using the Feature API:
+
+```typescript
+// Disable text-to-video generation
+cesdk.feature.enable('ly.img.plugin-ai-video-generation-web.fromText', false);
+
+// Disable image-to-video generation  
+cesdk.feature.enable('ly.img.plugin-ai-video-generation-web.fromImage', false);
+
+// Disable provider selection
+cesdk.feature.enable('ly.img.plugin-ai-video-generation-web.providerSelect', false);
+
+// Disable specific quick actions
+cesdk.feature.enable('ly.img.plugin-ai-video-generation-web.quickAction.createVideo', false);
+```
+
+For more information about Feature API and available feature flags, see the [@imgly/plugin-ai-generation-web documentation](https://github.com/imgly/plugins/tree/main/packages/plugin-ai-generation-web#available-feature-flags).
+
 ### Customizing Labels and Translations
 
 You can customize all labels and text in the AI video generation interface using the translation system. This allows you to provide better labels for your users in any language.
@@ -464,6 +590,16 @@ FalAiVideo.MinimaxVideo01LiveImageToVideo(config: {
 }): AiVideoProvider
 ```
 
+#### MinimaxHailuo02StandardImageToVideo
+
+```typescript
+FalAiVideo.MinimaxHailuo02StandardImageToVideo(config: {
+  proxyUrl: string;
+  headers?: Record<string, string>;
+  debug?: boolean;
+}): AiVideoProvider
+```
+
 #### PixverseV35TextToVideo
 
 ```typescript
@@ -492,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
@@ -517,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
@@ -528,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;