pixverse 1.3.1 → 1.3.2

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
@@ -59,15 +59,15 @@ This opens a browser where you confirm the authorization. You can also copy the
59
59
  | :---------------------- | :---------------------- | :---------------------------------- | :------------ | :------------------------------------------------- |
60
60
  | PixVerse V6 _(default)_ | `v6` | `360p` `540p` `720p` `1080p` | `1`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `3:2` `2:3` `21:9` |
61
61
  | PixVerse C1 | `pixverse-c1` | `360p` `540p` `720p` `1080p` | `1`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `3:2` `2:3` |
62
- | Seedance 2.5 | `seedance-2.5` | `480p` `720p` | `4`–`30`s | `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` |
62
+ | Seedance 2.5 | `seedance-2.5` | `480p` `720p` | `4`–`30`s | `auto` `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` |
63
63
  | Seedance 2.0 Standard | `seedance-2.0-standard` | `480p` `720p` `1080p` `2160p` | `4`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` |
64
64
  | Seedance 2.0 Fast | `seedance-2.0-fast` | `480p` `720p` | `4`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` |
65
65
  | Seedance 2.0 Mini | `seedance-2.0-mini` | `480p` `720p` | `4`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` |
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` | `3`–`15`s | `16:9` `9:16` `1:1` |
70
- | Kling O3 Standard | `kling-o3-standard` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
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
71
  | Kling 3.0 Pro | `kling-3.0-pro` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
72
72
  | Kling 3.0 Standard | `kling-3.0-standard` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
73
73
  | Grok Imagine 1.5 | `grok-imagine-1.5` | `480p` `720p` | `1`–`15`s | _from image_ |
@@ -81,10 +81,12 @@ This opens a browser where you confirm the authorization. You can also copy the
81
81
  | 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
82
  | 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
83
 
84
- > Seedance 2.5 defaults to `720p`, 5 seconds, and `16:9`. Text-to-video, image-to-video, and reference mode accept its fixed aspect ratios. Transition does not send a user-selected aspect ratio. Generated audio, multi-shot, and off-peak generation are unsupported.
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.
85
85
 
86
86
  > 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
87
 
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.
89
+
88
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).
89
91
 
90
92
  > Not all models support all creation modes. See the per-mode support matrix below.
@@ -95,7 +97,7 @@ This opens a browser where you confirm the authorization. You can also copy the
95
97
  | :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
96
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` |
97
99
  | `create extend` | `v6` `grok-imagine` |
98
- | `create reference` (multi-subject reference) | `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` |
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` |
99
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` |
100
102
  | `create transition` (3+ frames) | `v5` |
101
103
  | `create modify` | `v5.5` |
@@ -166,6 +168,9 @@ pixverse create video --prompt "A cat walking on Mars" --model v6 --quality 720p
166
168
 
167
169
  # Seedance 2.5 supports integer durations from 4 through 30 seconds
168
170
  pixverse create video --prompt "A slow aerial orbit around an alpine lake" --model seedance-2.5 --quality 720p --duration 12 --aspect-ratio 21:9
171
+
172
+ # Seedance 2.5 can let the model determine the text-to-video aspect ratio
173
+ pixverse create video --prompt "A cinematic landscape revealed through fog" --model seedance-2.5 --aspect-ratio auto
169
174
  ```
170
175
 
171
176
  ### Text inputs: literal, a file, or stdin
@@ -241,12 +246,24 @@ pixverse create modify --video <video_id> --prompt "Change the background to a b
241
246
  # Upscale video resolution
242
247
  pixverse create upscale --video <video_id> --quality 2160p
243
248
 
244
- # Generate video with character reference (1–7 images)
245
- pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park"
249
+ # Generate video from image references (V6 accepts up to 10 images)
250
+ pixverse create reference -m v6 --images ./char1.png ./char2.png --prompt "Two friends walking in a park"
251
+
252
+ # Edit video with V6 reference media (up to 2 videos, rounded total ≤ 15s)
253
+ pixverse create reference -m v6 --videos ./shot1.mp4 ./shot2.mov --duration auto --prompt "Turn the scene into a rainy night"
254
+
255
+ # Gemini Omni derives output duration from its single source video (up to 10s)
256
+ pixverse create reference -m gemini-omni-flash --images ./style.png --videos ./source.mp4 --prompt "Keep @video1's motion and apply @image1's style"
257
+
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"
260
+
261
+ # Grok Imagine accepts images or one MP4 video, but not both (video ≤ 8.7s)
262
+ pixverse create reference -m grok-imagine --videos ./source.mp4 --prompt "Replace the background with a desert"
246
263
 
247
264
  # Seedance 2.5 reference — up to 50 total inputs: 30 images, 10 videos, and 10 audios;
248
265
  # video and audio totals are each limited to 30s, and audio needs an image or video
249
- pixverse create reference -m seedance-2.5 --images ./char.png --videos ./motion.mp4 --audios ./voice.mp3 --aspect-ratio 16:9 --prompt "@image1 follows @video1 and @audio1"
266
+ 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"
250
267
 
251
268
  # Seedance 2.0 reference — mix images and videos (max 3 videos, total ≤ 15s)
252
269
  pixverse create reference -m seedance-2.0-standard --images ./char.png --videos ./motion.mp4 --prompt "@image1 follows the motion in @video1"
@@ -526,7 +543,7 @@ pixverse asset download "$VID" --dest ./output/
526
543
  | `create extend` | Extend video duration |
527
544
  | `create modify` | Modify an existing video |
528
545
  | `create upscale` | Upscale video resolution |
529
- | `create reference` | Generate video with character references |
546
+ | `create reference` | Create or edit a video with reference media |
530
547
  | `create motion-control` | Motion control with character image + reference video |
531
548
  | `create template` | Create from a template/effect |
532
549
  | `template categories` | List template categories |
@@ -5,7 +5,7 @@
5
5
  "cli": {
6
6
  "name": "pixverse",
7
7
  "package": "pixverse",
8
- "version": "1.3.1",
8
+ "version": "1.3.2",
9
9
  "binary": "pixverse",
10
10
  "node": ">=20",
11
11
  "description": "PixVerse CLI - generate videos and images from the command line"
@@ -124,7 +124,7 @@
124
124
  "-m, --model <model>": "Video model",
125
125
  "-d, --duration <seconds>": "Duration in seconds",
126
126
  "-q, --quality <quality>": "Video quality",
127
- "--aspect-ratio <ratio>": "Aspect ratio",
127
+ "--aspect-ratio <ratio>": "Aspect ratio, or auto for model-determined framing where supported",
128
128
  "--seed <number>": "Random seed",
129
129
  "--count <number>": "Number of generations",
130
130
  "--audio": "Enable audio generation",
@@ -295,19 +295,19 @@
295
295
  },
296
296
  {
297
297
  "cmd": "pixverse create reference",
298
- "desc": "Multi-subject character reference video",
298
+ "desc": "Create or edit a video with reference media",
299
299
  "run": true,
300
300
  "auth": true,
301
301
  "effect": "creates_remote_media_asset",
302
302
  "options": {
303
- "--images <inputs...>": "Image inputs: file paths, HTTPS URLs, image IDs, or media paths (max 30 for seedance-2.5, 9 for seedance-2.0 and minimax-h3, 5 for gemini-omni-flash, otherwise 7; local oversized images are auto-resized to fit 1920x1920)",
304
- "--videos <inputs...>": "Video reference inputs (Seedance and minimax-h3): file paths, HTTPS URLs, video IDs, or media paths (seedance-2.5: max 10 and ≤30s total; others: max 3, seedance-2.0 ≤15s total)",
303
+ "--images <inputs...>": "Image references: file paths, HTTPS URLs, image IDs, or media paths (model-specific limits; local oversized images are auto-resized to fit 1920x1920)",
304
+ "--videos <inputs...>": "Video references: file paths, HTTPS URLs, video IDs, or media paths (supported by V6, Seedance, MiniMax H3, Gemini Omni, Kling O3, and Grok Imagine; model-specific limits apply)",
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
308
  "-q, --quality <quality>": "Video quality",
309
- "--aspect-ratio <ratio>": "Aspect ratio",
310
- "-d, --duration <seconds>": "Duration in seconds",
309
+ "--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
311
  "--count <number>": "Number of generations",
312
312
  "--seed <number>": "Random seed",
313
313
  "--audio": "Enable audio generation",