pixverse 1.3.2 → 1.3.3

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.
package/README.md CHANGED
@@ -32,7 +32,7 @@ Or run without installing:
32
32
  npx pixverse
33
33
  ```
34
34
 
35
- **Requirements:** Node.js >= 20
35
+ **Requirements:** Node.js >= 22.12
36
36
 
37
37
  ## Authentication
38
38
 
@@ -66,11 +66,13 @@ This opens a browser where you confirm the authorization. You can also copy the
66
66
  | MiniMax H3 | `minimax-h3` | `768p` `1440p` | `5`–`15`s | `auto` `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` |
67
67
  | Google Gemini Omni | `gemini-omni-flash` | `720p` | `3`–`10`s | `16:9` `9:16` |
68
68
  | Happy Horse 1.0 | `happyhorse-1.0` | `720p` `1080p` | `3`–`15`s | `16:9` `9:16` `1:1` `4:3` `3:4` |
69
- | Kling O3 Pro | `kling-o3-pro` | `720p` `1080p` | `3`–`15`s | `16:9` `9:16` `1:1` |
70
- | Kling O3 Standard | `kling-o3-standard` | `720p` `1080p` | `3`–`15`s | `16:9` `9:16` `1:1` |
71
- | Kling 3.0 Pro | `kling-3.0-pro` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
72
- | Kling 3.0 Standard | `kling-3.0-standard` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
73
- | Grok Imagine 1.5 | `grok-imagine-1.5` | `480p` `720p` | `1`–`15`s | _from image_ |
69
+ | Kling O3 Pro | `kling-o3-pro` | _not applicable_ | `3`–`15`s | `16:9` `9:16` `1:1` |
70
+ | Kling O3 Standard | `kling-o3-standard` | _not applicable_ | `3`–`15`s | `16:9` `9:16` `1:1` |
71
+ | Kling O3 4K | `kling-o3-4k` | _not applicable_ | `3`–`15`s | `16:9` `9:16` `1:1` |
72
+ | Kling 3.0 Pro | `kling-3.0-pro` | _not applicable_ | `3`–`15`s | `16:9` `9:16` `1:1` |
73
+ | Kling 3.0 Standard | `kling-3.0-standard` | _not applicable_ | `3`–`15`s | `16:9` `9:16` `1:1` |
74
+ | Kling 3.0 4K | `kling-3.0-4k` | _not applicable_ | `3`–`15`s | `16:9` `9:16` `1:1` |
75
+ | Grok Imagine 1.5 | `grok-imagine-1.5` | `480p` `720p` `1080p` | `1`–`15`s | _from image_ |
74
76
  | Grok Imagine | `grok-imagine` | `480p` `720p` | `1`–`15`s | `16:9` `4:3` `1:1` `9:16` `3:4` `3:2` `2:3` |
75
77
  | Veo 3.1 Lite | `veo-3.1-lite` | `720p` `1080p` | `4` `6` `8`s | `16:9` `9:16` |
76
78
  | Veo 3.1 Standard | `veo-3.1-standard` | `720p` `1080p` `2160p` | `4` `6` `8`s | `16:9` `9:16` |
@@ -81,27 +83,29 @@ This opens a browser where you confirm the authorization. You can also copy the
81
83
  | PixVerse v5.5 | `v5.5` | `360p` `480p` `540p` `720p` `1080p` | `1`–`10`s | `16:9` `4:3` `1:1` `3:4` `9:16` `3:2` `2:3` |
82
84
  | PixVerse v5 | `v5` | `360p` `480p` `540p` `720p` `1080p` | `1`–`10`s | `16:9` `4:3` `1:1` `3:4` `9:16` `3:2` `2:3` |
83
85
 
84
- > Seedance 2.5 defaults to `720p`, 5 seconds, and `16:9` for generation without a reference video. Text-to-video and reference mode accept `--aspect-ratio auto` in addition to the fixed ratios. Reference requests containing a video default to automatic duration and lock the aspect ratio to `auto`; selecting an integer from 4 through 30 unlocks both automatic and fixed aspect ratios. Image-to-video retains its existing fixed-ratio behavior, while transition does not send a user-selected aspect ratio. Generated audio, multi-shot, and off-peak generation are unsupported.
86
+ > Seedance 2.5 defaults to `720p`, 5 seconds, and `16:9` for generation without a reference video. Text-to-video and reference mode accept `--aspect-ratio auto` in addition to the fixed ratios. Reference requests containing a video default to automatic duration and lock the aspect ratio to `auto`; selecting an integer from 4 through 30 unlocks both automatic and fixed aspect ratios. Reference mode also accepts the optional `--task-type <type>` flag (`auto` by default, `reference`, `edit`, or `extend`) to guide the task intent; this flag is rejected for other models. Image-to-video retains its existing fixed-ratio behavior, while transition does not send a user-selected aspect ratio. Generated audio, multi-shot, and off-peak generation are unsupported.
85
87
 
86
88
  > MiniMax H3 text-to-video defaults to `16:9`. Image-to-video forces `auto`; reference mode with images supports both `auto` and fixed aspect ratios and defaults to `auto`.
87
89
 
88
- > Reference video editing: V6 accepts up to 10 images and 2 videos (15s total after per-clip rounding); requests with a video lock duration to `auto` and reject fixed values. Seedance 2.5 accepts up to 10 videos (30s total); requests with a video default to `auto` but may select a fixed 4–30 seconds. Gemini Omni accepts up to 5 images and 1 video up to 10s. Kling O3 accepts up to 7 images without video or 4 images with 1 video up to 15s (200MB, 2048px per side). Grok Imagine accepts either 1–7 images or exactly 1 MP4 video up to 8.7s; video mode forces `auto`. Gemini Omni and Grok Imagine derive output duration from the source video when metadata is available.
90
+ > Kling resolution is selected entirely by the model ID. Kling requests do not send `quality`; an explicit `--quality` value is ignored with a warning. Both 4K models support text/image-to-video and two-frame transitions, while only Kling O3 4K supports `create reference`.
89
91
 
90
- > Grok Imagine 1.5 is image-to-video only it requires `--image` and derives its aspect ratio from the input image (the `--aspect-ratio` flag is ignored).
92
+ > Reference video editing: V6 accepts up to 10 images and 2 videos (15s total after per-clip rounding); requests with a video lock duration to `auto` and reject fixed values. Seedance 2.5 accepts up to 10 videos (30s total); requests with a video default to `auto` but may select a fixed 4–30 seconds. Gemini Omni accepts up to 5 images and 1 video up to 10s; requests with a video lock duration to `auto` and reject fixed values. Kling O3 accepts up to 7 images without video or 4 images with 1 video up to 15s (200MB, 2048px per side). Grok Imagine accepts either 1–7 images with normal fixed duration or exactly 1 MP4 video up to 8.7s; video mode locks duration to `auto` and derives aspect ratio from the source video.
93
+
94
+ > Grok Imagine 1.5 is image-to-video only — it requires `--image`, supports `480p`, `720p`, and `1080p`, and derives its aspect ratio from the input image (the `--aspect-ratio` flag is ignored).
91
95
 
92
96
  > Not all models support all creation modes. See the per-mode support matrix below.
93
97
 
94
98
  #### Per-mode Model Support
95
99
 
96
- | Creation mode | Supported `--model` values |
97
- | :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
98
- | `create video` (text-to-video / image-to-video) | `v6` `pixverse-c1` `seedance-2.5` `seedance-2.0-standard` `seedance-2.0-fast` `seedance-2.0-mini` `minimax-h3` `gemini-omni-flash` `happyhorse-1.0` `kling-o3-pro` `kling-o3-standard` `kling-3.0-pro` `kling-3.0-standard` `grok-imagine-1.5` `grok-imagine` `veo-3.1-lite` `veo-3.1-standard` `veo-3.1-fast` `sora-2-pro` `sora-2` `v5.6` |
99
- | `create extend` | `v6` `grok-imagine` |
100
- | `create reference` (reference / video editing) | `v6` `pixverse-c1` `seedance-2.5` `seedance-2.0-standard` `seedance-2.0-fast` `seedance-2.0-mini` `minimax-h3` `gemini-omni-flash` `kling-o3-pro` `kling-o3-standard` `grok-imagine` `v5.6` |
101
- | `create transition` (2 frames) | `v6` `pixverse-c1` `seedance-2.5` `seedance-2.0-standard` `seedance-2.0-fast` `seedance-2.0-mini` `minimax-h3` `kling-o3-pro` `kling-o3-standard` `kling-3.0-pro` `kling-3.0-standard` `veo-3.1-lite` `veo-3.1-standard` `veo-3.1-fast` `v5.6` |
102
- | `create transition` (3+ frames) | `v5` |
103
- | `create modify` | `v5.5` |
104
- | `create motion-control` | `v5.6` |
100
+ | Creation mode | Supported `--model` values |
101
+ | :---------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
102
+ | `create video` (text-to-video / image-to-video) | `v6` `pixverse-c1` `seedance-2.5` `seedance-2.0-standard` `seedance-2.0-fast` `seedance-2.0-mini` `minimax-h3` `gemini-omni-flash` `happyhorse-1.0` `kling-o3-pro` `kling-o3-standard` `kling-o3-4k` `kling-3.0-pro` `kling-3.0-standard` `kling-3.0-4k` `grok-imagine-1.5` `grok-imagine` `veo-3.1-lite` `veo-3.1-standard` `veo-3.1-fast` `sora-2-pro` `sora-2` `v5.6` |
103
+ | `create extend` | `v6` `grok-imagine` |
104
+ | `create reference` (reference / video editing) | `v6` `pixverse-c1` `seedance-2.5` `seedance-2.0-standard` `seedance-2.0-fast` `seedance-2.0-mini` `minimax-h3` `gemini-omni-flash` `kling-o3-pro` `kling-o3-standard` `kling-o3-4k` `grok-imagine` `v5.6` |
105
+ | `create transition` (2 frames) | `v6` `pixverse-c1` `seedance-2.5` `seedance-2.0-standard` `seedance-2.0-fast` `seedance-2.0-mini` `minimax-h3` `kling-o3-pro` `kling-o3-standard` `kling-o3-4k` `kling-3.0-pro` `kling-3.0-standard` `kling-3.0-4k` `veo-3.1-lite` `veo-3.1-standard` `veo-3.1-fast` `v5.6` |
106
+ | `create transition` (3+ frames) | `v5` |
107
+ | `create modify` | `v5.5` |
108
+ | `create motion-control` | `v5.6` |
105
109
 
106
110
  > Audio creation uses separate model families: `create voice` for text-to-speech and `create music` for prompt-to-music.
107
111
 
@@ -252,17 +256,18 @@ pixverse create reference -m v6 --images ./char1.png ./char2.png --prompt "Two f
252
256
  # Edit video with V6 reference media (up to 2 videos, rounded total ≤ 15s)
253
257
  pixverse create reference -m v6 --videos ./shot1.mp4 ./shot2.mov --duration auto --prompt "Turn the scene into a rainy night"
254
258
 
255
- # Gemini Omni derives output duration from its single source video (up to 10s)
259
+ # Gemini Omni defaults to automatic duration with its single source video (up to 10s)
256
260
  pixverse create reference -m gemini-omni-flash --images ./style.png --videos ./source.mp4 --prompt "Keep @video1's motion and apply @image1's style"
257
261
 
258
- # Kling O3 accepts up to 4 images when a video is present (video ≤ 15s, 200MB, 2048px per side)
259
- pixverse create reference -m kling-o3-pro --images ./character.png --videos ./motion.mov --quality 1080p --prompt "Use @image1 as the subject in @video1"
262
+ # Kling O3 4K accepts up to 4 images when a video is present (video ≤ 15s, 200MB, 2048px per side)
263
+ pixverse create reference -m kling-o3-4k --images ./character.png --videos ./motion.mov --prompt "Use @image1 as the subject in @video1"
260
264
 
261
265
  # Grok Imagine accepts images or one MP4 video, but not both (video ≤ 8.7s)
262
266
  pixverse create reference -m grok-imagine --videos ./source.mp4 --prompt "Replace the background with a desert"
263
267
 
264
268
  # Seedance 2.5 reference — up to 50 total inputs: 30 images, 10 videos, and 10 audios;
265
- # video and audio totals are each limited to 30s, and audio needs an image or video
269
+ # video and audio totals are each limited to 30s, audio needs an image or video,
270
+ # and --task-type defaults to auto (or explicitly accepts reference, edit, or extend)
266
271
  pixverse create reference -m seedance-2.5 --images ./char.png --videos ./motion.mp4 --audios ./voice.mp3 --duration auto --aspect-ratio auto --prompt "@image1 follows @video1 and @audio1"
267
272
 
268
273
  # Seedance 2.0 reference — mix images and videos (max 3 videos, total ≤ 15s)
@@ -5,9 +5,9 @@
5
5
  "cli": {
6
6
  "name": "pixverse",
7
7
  "package": "pixverse",
8
- "version": "1.3.2",
8
+ "version": "1.3.3",
9
9
  "binary": "pixverse",
10
- "node": ">=20",
10
+ "node": ">=22.12.0",
11
11
  "description": "PixVerse CLI - generate videos and images from the command line"
12
12
  },
13
13
  "contract": {
@@ -305,9 +305,10 @@
305
305
  "--audios <inputs...>": "Audio reference inputs (Seedance and minimax-h3): file paths, HTTPS URLs, audio IDs, or media paths (seedance-2.5: max 10 and ≤30s total; others: max 3, seedance-2.0 clips 2–15s and ≤15s total; requires an image or video)",
306
306
  "--prompt <text>": "Prompt text",
307
307
  "-m, --model <model>": "Video model",
308
+ "--task-type <type>": "Seedance 2.5 reference task type: auto, reference, edit, or extend",
308
309
  "-q, --quality <quality>": "Video quality",
309
310
  "--aspect-ratio <ratio>": "Aspect ratio, or auto for model-determined framing where supported",
310
- "-d, --duration <seconds|auto>": "Duration in seconds, or auto (locked for V6 video references; default for Seedance 2.5 video references)",
311
+ "-d, --duration <seconds|auto>": "Duration in seconds, or auto (locked for V6/Grok video references; default for Seedance 2.5 video references)",
311
312
  "--count <number>": "Number of generations",
312
313
  "--seed <number>": "Random seed",
313
314
  "--audio": "Enable audio generation",