@imgly/plugin-ai-video-generation-web 0.2.12 → 0.2.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +319 -0
  3. package/dist/.tsbuildinfo +1 -1
  4. package/dist/eachlabs/KlingO1.image2video.d.ts +23 -0
  5. package/dist/eachlabs/KlingV26Pro.image2video.d.ts +23 -0
  6. package/dist/eachlabs/KlingV26Pro.text2video.d.ts +24 -0
  7. package/dist/eachlabs/Veo31.image2video.d.ts +25 -0
  8. package/dist/eachlabs/Veo31.text2video.d.ts +25 -0
  9. package/dist/eachlabs/createEachLabsClient.d.ts +37 -0
  10. package/dist/eachlabs/createVideoProvider.d.ts +107 -0
  11. package/dist/eachlabs/index.d.ts +19 -0
  12. package/dist/eachlabs/index.mjs +142 -0
  13. package/dist/eachlabs/index.mjs.map +7 -0
  14. package/dist/eachlabs/types.d.ts +10 -0
  15. package/dist/eachlabs/utils.d.ts +23 -0
  16. package/dist/fal-ai/index.mjs.map +2 -2
  17. package/dist/index.mjs +1 -1
  18. package/dist/index.mjs.map +2 -2
  19. package/dist/runware/Sora2.image2video.d.ts +32 -0
  20. package/dist/runware/Sora2.text2video.d.ts +30 -0
  21. package/dist/runware/Sora2Pro.image2video.d.ts +32 -0
  22. package/dist/runware/Sora2Pro.text2video.d.ts +30 -0
  23. package/dist/runware/Veo31.image2video.d.ts +33 -0
  24. package/dist/runware/Veo31.text2video.d.ts +31 -0
  25. package/dist/runware/Veo31Fast.image2video.d.ts +34 -0
  26. package/dist/runware/Veo31Fast.text2video.d.ts +32 -0
  27. package/dist/runware/createRunwareClient.d.ts +57 -0
  28. package/dist/runware/createVideoProvider.d.ts +109 -0
  29. package/dist/runware/index.d.ts +28 -0
  30. package/dist/runware/index.mjs +142 -0
  31. package/dist/runware/index.mjs.map +7 -0
  32. package/dist/runware/types.d.ts +10 -0
  33. package/dist/runware/utils.d.ts +5 -0
  34. package/package.json +43 -23
package/CHANGELOG.md CHANGED
@@ -2,6 +2,24 @@
2
2
 
3
3
  ## [Unreleased]
4
4
 
5
+ ## [0.2.15] - 2026-01-12
6
+
7
+ ### New Features
8
+
9
+ - [all] **EachLabs Partner Integration**: Added EachLabs as a new AI provider service with unified API access to multiple image and video generation models.
10
+ - **Image Generation**: Flux 2 Pro, Flux 2, Flux 2 Flex, Nano Banana Pro, OpenAI GPT Image, Seedream v4.5, Gemini 3 Pro (all with text-to-image and image-to-image variants)
11
+ - **Video Generation**: Kling v2.6 Pro, Kling O1, Veo 3.1 (text-to-video and image-to-video variants)
12
+
13
+ ## [0.2.14] - 2025-12-15
14
+
15
+ ## [0.2.13] - 2025-12-15
16
+
17
+ ### New Features
18
+
19
+ - [all] **Runware Partner Integration**: Added Runware as a new AI provider service, offering access to multiple image and video generation models through a unified API. Runware provides a single endpoint for accessing various AI models with consistent configuration.
20
+ - **Image Generation**: FLUX.2 [dev], FLUX.2 [pro], FLUX.2 [flex], Seedream 4.0, Seedream 4.5, Nano Banana 2 Pro, GPT Image 1, GPT Image 1 Mini (all with text-to-image and image-to-image variants)
21
+ - **Video Generation**: Google Veo 3.1, Veo 3.1 Fast, OpenAI Sora 2, Sora 2 Pro (all with text-to-video and image-to-video variants)
22
+
5
23
  ## [0.2.12] - 2025-11-21
6
24
 
7
25
  ## [0.2.11] - 2025-11-21
package/README.md CHANGED
@@ -33,6 +33,8 @@ To use the plugin, import it and configure it with your preferred providers:
33
33
  import CreativeEditorSDK from '@cesdk/cesdk-js';
34
34
  import VideoGeneration from '@imgly/plugin-ai-video-generation-web';
35
35
  import FalAiVideo from '@imgly/plugin-ai-video-generation-web/fal-ai';
36
+ // For Runware providers
37
+ import RunwareVideo from '@imgly/plugin-ai-video-generation-web/runware';
36
38
 
37
39
  // Initialize CreativeEditor SDK
38
40
  CreativeEditorSDK.create(domElement, {
@@ -498,6 +500,213 @@ Key features:
498
500
 
499
501
  **Note:** This provider uses a custom UI implementation with two image input fields (first_frame_url and last_frame_url) instead of the standard single image selector. This is a proof-of-concept implementation for handling multiple image inputs in video generation.
500
502
 
503
+ ### Runware Providers
504
+
505
+ Runware provides access to multiple AI video models through a unified API. These providers require a Runware proxy URL for authentication.
506
+
507
+ #### 14. Veo31 (Text-to-Video & Image-to-Video) via Runware
508
+
509
+ Google's Veo 3.1 model accessed through Runware:
510
+
511
+ ```typescript
512
+ // Text-to-Video
513
+ text2video: RunwareVideo.Veo31.Text2Video({
514
+ proxyUrl: 'http://your-runware-proxy.com/api/proxy'
515
+ })
516
+
517
+ // Image-to-Video
518
+ image2video: RunwareVideo.Veo31.Image2Video({
519
+ proxyUrl: 'http://your-runware-proxy.com/api/proxy'
520
+ })
521
+ ```
522
+
523
+ Key features:
524
+ - Google's latest video generation model via Runware
525
+ - Text-to-video and image-to-video support
526
+ - Aspect ratios: 16:9, 9:16
527
+ - Duration: Fixed at 8 seconds
528
+ - Optional audio generation
529
+ - Async delivery with polling
530
+
531
+ #### 15. Veo31Fast (Text-to-Video & Image-to-Video) via Runware
532
+
533
+ Faster version of Google's Veo 3.1 model:
534
+
535
+ ```typescript
536
+ // Text-to-Video
537
+ text2video: RunwareVideo.Veo31Fast.Text2Video({
538
+ proxyUrl: 'http://your-runware-proxy.com/api/proxy'
539
+ })
540
+
541
+ // Image-to-Video
542
+ image2video: RunwareVideo.Veo31Fast.Image2Video({
543
+ proxyUrl: 'http://your-runware-proxy.com/api/proxy'
544
+ })
545
+ ```
546
+
547
+ Key features:
548
+ - Faster generation times
549
+ - Same capabilities as Veo31
550
+ - More cost-effective
551
+ - Aspect ratios: 16:9, 9:16
552
+ - Duration: Fixed at 8 seconds
553
+
554
+ #### 16. Sora2 (Text-to-Video & Image-to-Video) via Runware
555
+
556
+ OpenAI's Sora 2 video generation model:
557
+
558
+ ```typescript
559
+ // Text-to-Video
560
+ text2video: RunwareVideo.Sora2.Text2Video({
561
+ proxyUrl: 'http://your-runware-proxy.com/api/proxy'
562
+ })
563
+
564
+ // Image-to-Video
565
+ image2video: RunwareVideo.Sora2.Image2Video({
566
+ proxyUrl: 'http://your-runware-proxy.com/api/proxy'
567
+ })
568
+ ```
569
+
570
+ Key features:
571
+ - OpenAI's advanced video generation model
572
+ - Text-to-video and image-to-video support
573
+ - Accurate physics simulation
574
+ - Synchronized dialogue and high-fidelity visuals
575
+ - Resolutions: 1280×720, 720×1280
576
+ - Durations: 4, 8, or 12 seconds
577
+
578
+ #### 17. Sora2Pro (Text-to-Video & Image-to-Video) via Runware
579
+
580
+ Professional version of OpenAI's Sora 2:
581
+
582
+ ```typescript
583
+ // Text-to-Video
584
+ text2video: RunwareVideo.Sora2Pro.Text2Video({
585
+ proxyUrl: 'http://your-runware-proxy.com/api/proxy'
586
+ })
587
+
588
+ // Image-to-Video
589
+ image2video: RunwareVideo.Sora2Pro.Image2Video({
590
+ proxyUrl: 'http://your-runware-proxy.com/api/proxy'
591
+ })
592
+ ```
593
+
594
+ Key features:
595
+ - Enhanced quality over standard Sora 2
596
+ - Text-to-video and image-to-video support
597
+ - Professional-grade output
598
+ - Resolutions: 1280×720, 720×1280, 1792×1024 (7:4), 1024×1792 (4:7)
599
+ - Durations: 4, 8, or 12 seconds
600
+
601
+ ### EachLabs Providers
602
+
603
+ EachLabs provides access to multiple AI video models through a unified API. These providers require an EachLabs proxy URL for authentication.
604
+
605
+ #### 18. KlingV26ProTextToVideo (Text-to-Video) via EachLabs
606
+
607
+ Kling v2.6 Pro text-to-video model accessed through EachLabs:
608
+
609
+ ```typescript
610
+ import EachLabsVideo from '@imgly/plugin-ai-video-generation-web/eachlabs';
611
+
612
+ text2video: EachLabsVideo.KlingV26ProTextToVideo({
613
+ proxyUrl: 'http://your-eachlabs-proxy.com/api/proxy',
614
+ // Optional: Configure default values
615
+ middlewares: [rateLimitMiddleware, errorMiddleware]
616
+ })
617
+ ```
618
+
619
+ Key features:
620
+ - Kling v2.6 Pro - latest high-quality video generation
621
+ - Aspect ratios: 16:9, 9:16, 1:1
622
+ - Duration: 5 or 10 seconds
623
+ - Native audio generation (Chinese/English)
624
+ - Async delivery with polling
625
+
626
+ #### 19. KlingV26ProImageToVideo (Image-to-Video) via EachLabs
627
+
628
+ Kling v2.6 Pro image-to-video model:
629
+
630
+ ```typescript
631
+ import EachLabsVideo from '@imgly/plugin-ai-video-generation-web/eachlabs';
632
+
633
+ image2video: EachLabsVideo.KlingV26ProImageToVideo({
634
+ proxyUrl: 'http://your-eachlabs-proxy.com/api/proxy',
635
+ // Optional: Configure default values
636
+ middlewares: [rateLimitMiddleware, errorMiddleware]
637
+ })
638
+ ```
639
+
640
+ Key features:
641
+ - Transform existing images into videos
642
+ - Duration: 5 or 10 seconds
643
+ - Native audio generation (Chinese/English)
644
+ - Canvas quick-action integration
645
+ - Maintains image aspect ratio
646
+
647
+ #### 20. KlingO1ImageToVideo (Image-to-Video) via EachLabs
648
+
649
+ Kling O1 image-to-video model:
650
+
651
+ ```typescript
652
+ import EachLabsVideo from '@imgly/plugin-ai-video-generation-web/eachlabs';
653
+
654
+ image2video: EachLabsVideo.KlingO1ImageToVideo({
655
+ proxyUrl: 'http://your-eachlabs-proxy.com/api/proxy',
656
+ // Optional: Configure default values
657
+ middlewares: [rateLimitMiddleware, errorMiddleware]
658
+ })
659
+ ```
660
+
661
+ Key features:
662
+ - Transform existing images into videos
663
+ - Duration: 5 or 10 seconds
664
+ - Canvas quick-action integration
665
+ - Maintains image aspect ratio
666
+
667
+ #### 22. Veo31TextToVideo (Text-to-Video) via EachLabs
668
+
669
+ Google's Veo 3.1 text-to-video model accessed through EachLabs:
670
+
671
+ ```typescript
672
+ import EachLabsVideo from '@imgly/plugin-ai-video-generation-web/eachlabs';
673
+
674
+ text2video: EachLabsVideo.Veo31TextToVideo({
675
+ proxyUrl: 'http://your-eachlabs-proxy.com/api/proxy',
676
+ // Optional: Configure default values
677
+ middlewares: [rateLimitMiddleware, errorMiddleware]
678
+ })
679
+ ```
680
+
681
+ Key features:
682
+ - Google's Veo 3.1 - high-quality text-to-video generation
683
+ - Aspect ratios: 16:9, 9:16
684
+ - Resolution: 720p or 1080p
685
+ - 8-second video duration
686
+ - Optional audio generation
687
+ - Async delivery with polling
688
+
689
+ #### 23. Veo31ImageToVideo (Image-to-Video) via EachLabs
690
+
691
+ Google's Veo 3.1 image-to-video model:
692
+
693
+ ```typescript
694
+ import EachLabsVideo from '@imgly/plugin-ai-video-generation-web/eachlabs';
695
+
696
+ image2video: EachLabsVideo.Veo31ImageToVideo({
697
+ proxyUrl: 'http://your-eachlabs-proxy.com/api/proxy',
698
+ // Optional: Configure default values
699
+ middlewares: [rateLimitMiddleware, errorMiddleware]
700
+ })
701
+ ```
702
+
703
+ Key features:
704
+ - Transform existing images into videos
705
+ - Resolution: 720p or 1080p
706
+ - 8-second video duration
707
+ - Optional audio generation
708
+ - Canvas quick-action integration
709
+
501
710
  ### Feature Control
502
711
 
503
712
  You can control various aspects of the video generation plugin using the Feature API:
@@ -871,6 +1080,90 @@ FalAiVideo.Veo31FastFirstLastFrameToVideo(config: {
871
1080
  }): AiVideoProvider
872
1081
  ```
873
1082
 
1083
+ ### Runware Providers
1084
+
1085
+ All Runware video providers use the following configuration:
1086
+
1087
+ ```typescript
1088
+ interface RunwareProviderConfiguration {
1089
+ proxyUrl: string; // HTTP endpoint URL for the Runware proxy
1090
+ debug?: boolean; // Enable debug logging
1091
+ middlewares?: any[]; // Optional middleware functions
1092
+ history?: false | '@imgly/local' | '@imgly/indexedDB' | (string & {});
1093
+ }
1094
+ ```
1095
+
1096
+ #### Veo31.Text2Video / Veo31.Image2Video
1097
+
1098
+ ```typescript
1099
+ RunwareVideo.Veo31.Text2Video(config: RunwareProviderConfiguration)
1100
+ RunwareVideo.Veo31.Image2Video(config: RunwareProviderConfiguration)
1101
+ ```
1102
+
1103
+ #### Veo31Fast.Text2Video / Veo31Fast.Image2Video
1104
+
1105
+ ```typescript
1106
+ RunwareVideo.Veo31Fast.Text2Video(config: RunwareProviderConfiguration)
1107
+ RunwareVideo.Veo31Fast.Image2Video(config: RunwareProviderConfiguration)
1108
+ ```
1109
+
1110
+ #### Sora2.Text2Video / Sora2.Image2Video
1111
+
1112
+ ```typescript
1113
+ RunwareVideo.Sora2.Text2Video(config: RunwareProviderConfiguration)
1114
+ RunwareVideo.Sora2.Image2Video(config: RunwareProviderConfiguration)
1115
+ ```
1116
+
1117
+ #### Sora2Pro.Text2Video / Sora2Pro.Image2Video
1118
+
1119
+ ```typescript
1120
+ RunwareVideo.Sora2Pro.Text2Video(config: RunwareProviderConfiguration)
1121
+ RunwareVideo.Sora2Pro.Image2Video(config: RunwareProviderConfiguration)
1122
+ ```
1123
+
1124
+ ### EachLabs Providers
1125
+
1126
+ All EachLabs video providers use the following configuration:
1127
+
1128
+ ```typescript
1129
+ interface EachLabsProviderConfiguration {
1130
+ proxyUrl: string; // HTTP endpoint URL for the EachLabs proxy
1131
+ debug?: boolean; // Enable debug logging
1132
+ middlewares?: any[]; // Optional middleware functions
1133
+ history?: false | '@imgly/local' | '@imgly/indexedDB' | (string & {});
1134
+ }
1135
+ ```
1136
+
1137
+ #### KlingV26ProTextToVideo
1138
+
1139
+ ```typescript
1140
+ EachLabsVideo.KlingV26ProTextToVideo(config: EachLabsProviderConfiguration)
1141
+ ```
1142
+
1143
+ #### KlingV26ProImageToVideo
1144
+
1145
+ ```typescript
1146
+ EachLabsVideo.KlingV26ProImageToVideo(config: EachLabsProviderConfiguration)
1147
+ ```
1148
+
1149
+ #### KlingO1ImageToVideo
1150
+
1151
+ ```typescript
1152
+ EachLabsVideo.KlingO1ImageToVideo(config: EachLabsProviderConfiguration)
1153
+ ```
1154
+
1155
+ #### Veo31TextToVideo
1156
+
1157
+ ```typescript
1158
+ EachLabsVideo.Veo31TextToVideo(config: EachLabsProviderConfiguration)
1159
+ ```
1160
+
1161
+ #### Veo31ImageToVideo
1162
+
1163
+ ```typescript
1164
+ EachLabsVideo.Veo31ImageToVideo(config: EachLabsProviderConfiguration)
1165
+ ```
1166
+
874
1167
  ## UI Integration
875
1168
 
876
1169
  The plugin automatically registers the following UI components:
@@ -899,6 +1192,19 @@ The plugin automatically registers the following UI components:
899
1192
  - Veo31ImageToVideo: `ly.img.ai.fal-ai/veo3.1/image-to-video`
900
1193
  - Veo31FastImageToVideo: `ly.img.ai.fal-ai/veo3.1/fast/image-to-video`
901
1194
  - Veo31FastFirstLastFrameToVideo: `ly.img.ai.fal-ai/veo3.1/fast/first-last-frame-to-video`
1195
+ - Runware Veo31.Text2Video: `ly.img.ai.runware/google/veo-3-1`
1196
+ - Runware Veo31.Image2Video: `ly.img.ai.runware/google/veo-3-1/image2video`
1197
+ - Runware Veo31Fast.Text2Video: `ly.img.ai.runware/google/veo-3-1-fast`
1198
+ - Runware Veo31Fast.Image2Video: `ly.img.ai.runware/google/veo-3-1-fast/image2video`
1199
+ - Runware Sora2.Text2Video: `ly.img.ai.runware/openai/sora-2`
1200
+ - Runware Sora2.Image2Video: `ly.img.ai.runware/openai/sora-2/image2video`
1201
+ - Runware Sora2Pro.Text2Video: `ly.img.ai.runware/openai/sora-2-pro`
1202
+ - Runware Sora2Pro.Image2Video: `ly.img.ai.runware/openai/sora-2-pro/image2video`
1203
+ - EachLabs KlingV26ProTextToVideo: `ly.img.ai.eachlabs/kling-v2-6-pro-text-to-video`
1204
+ - EachLabs KlingV26ProImageToVideo: `ly.img.ai.eachlabs/kling-v2-6-pro-image-to-video`
1205
+ - EachLabs KlingO1ImageToVideo: `ly.img.ai.eachlabs/kling-o1-image-to-video`
1206
+ - EachLabs Veo31TextToVideo: `ly.img.ai.eachlabs/veo3-1-text-to-video`
1207
+ - EachLabs Veo31ImageToVideo: `ly.img.ai.eachlabs/veo3-1-image-to-video`
902
1208
 
903
1209
  ### Asset History
904
1210
 
@@ -918,6 +1224,19 @@ Generated videos are automatically stored in asset sources with the following ID
918
1224
  - Veo31ImageToVideo: `fal-ai/veo3.1/image-to-video.history`
919
1225
  - Veo31FastImageToVideo: `fal-ai/veo3.1/fast/image-to-video.history`
920
1226
  - Veo31FastFirstLastFrameToVideo: `fal-ai/veo3.1/fast/first-last-frame-to-video.history`
1227
+ - Runware Veo31.Text2Video: `runware/google/veo-3-1.history`
1228
+ - Runware Veo31.Image2Video: `runware/google/veo-3-1/image2video.history`
1229
+ - Runware Veo31Fast.Text2Video: `runware/google/veo-3-1-fast.history`
1230
+ - Runware Veo31Fast.Image2Video: `runware/google/veo-3-1-fast/image2video.history`
1231
+ - Runware Sora2.Text2Video: `runware/openai/sora-2.history`
1232
+ - Runware Sora2.Image2Video: `runware/openai/sora-2/image2video.history`
1233
+ - Runware Sora2Pro.Text2Video: `runware/openai/sora-2-pro.history`
1234
+ - Runware Sora2Pro.Image2Video: `runware/openai/sora-2-pro/image2video.history`
1235
+ - EachLabs KlingV26ProTextToVideo: `eachlabs/kling-v2-6-pro-text-to-video.history`
1236
+ - EachLabs KlingV26ProImageToVideo: `eachlabs/kling-v2-6-pro-image-to-video.history`
1237
+ - EachLabs KlingO1ImageToVideo: `eachlabs/kling-o1-image-to-video.history`
1238
+ - EachLabs Veo31TextToVideo: `eachlabs/veo3-1-text-to-video.history`
1239
+ - EachLabs Veo31ImageToVideo: `eachlabs/veo3-1-image-to-video.history`
921
1240
 
922
1241
  ### Dock Integration
923
1242