pixverse 1.3.0 → 1.3.1
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 +56 -38
- package/dist/capabilities.json +4 -4
- package/dist/index.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -59,10 +59,11 @@ 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
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` |
|
|
63
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` |
|
|
64
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` |
|
|
65
|
-
| MiniMax H3
|
|
66
|
+
| MiniMax H3 | `minimax-h3` | `768p` `1440p` | `5`–`15`s | `auto` `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` |
|
|
66
67
|
| Google Gemini Omni | `gemini-omni-flash` | `720p` | `3`–`10`s | `16:9` `9:16` |
|
|
67
68
|
| Happy Horse 1.0 | `happyhorse-1.0` | `720p` `1080p` | `3`–`15`s | `16:9` `9:16` `1:1` `4:3` `3:4` |
|
|
68
69
|
| Kling O3 Pro | `kling-o3-pro` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
|
|
@@ -80,6 +81,8 @@ This opens a browser where you confirm the authorization. You can also copy the
|
|
|
80
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` |
|
|
81
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` |
|
|
82
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.
|
|
85
|
+
|
|
83
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`.
|
|
84
87
|
|
|
85
88
|
> 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).
|
|
@@ -88,34 +91,34 @@ This opens a browser where you confirm the authorization. You can also copy the
|
|
|
88
91
|
|
|
89
92
|
#### Per-mode Model Support
|
|
90
93
|
|
|
91
|
-
| Creation mode | Supported `--model` values
|
|
92
|
-
| :---------------------------------------------- |
|
|
93
|
-
| `create video` (text-to-video / image-to-video) | `v6` `pixverse-c1` `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` |
|
|
94
|
-
| `create extend` | `v6` `grok-imagine`
|
|
95
|
-
| `create reference` (multi-subject reference) | `v6` `pixverse-c1` `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`
|
|
96
|
-
| `create transition` (2 frames) | `v6` `pixverse-c1` `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`
|
|
97
|
-
| `create transition` (3+ frames) | `v5`
|
|
98
|
-
| `create modify` | `v5.5`
|
|
99
|
-
| `create motion-control` | `v5.6`
|
|
94
|
+
| Creation mode | Supported `--model` values |
|
|
95
|
+
| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
96
|
+
| `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
|
+
| `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` |
|
|
99
|
+
| `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
|
+
| `create transition` (3+ frames) | `v5` |
|
|
101
|
+
| `create modify` | `v5.5` |
|
|
102
|
+
| `create motion-control` | `v5.6` |
|
|
100
103
|
|
|
101
104
|
> Audio creation uses separate model families: `create voice` for text-to-speech and `create music` for prompt-to-music.
|
|
102
105
|
|
|
103
106
|
### Image Models (`--model <value>`)
|
|
104
107
|
|
|
105
|
-
| Model | `--model` value
|
|
106
|
-
| :---------------------- |
|
|
107
|
-
| GPT Image 2 _(default)_ | `gpt-image-2.0`
|
|
108
|
-
| Nano Banana 2 | `gemini-3.1-flash`
|
|
108
|
+
| Model | `--model` value | Quality | Aspect Ratio |
|
|
109
|
+
| :---------------------- | :---------------------- | :----------------------------- | :------------------------------------------------------------- |
|
|
110
|
+
| GPT Image 2 _(default)_ | `gpt-image-2.0` | `1080p` `1440p` `2160p` | `1:1` `16:9` `9:16` `4:3` `3:4` `3:2` `2:3` `2:1` `1:2` `21:9` |
|
|
111
|
+
| Nano Banana 2 | `gemini-3.1-flash` | `512p` `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
|
|
109
112
|
| Nano Banana 2 Lite | `gemini-3.1-flash-lite` | `1080p` | `auto` `1:1` `16:9` `9:16` + more |
|
|
110
|
-
| Qwen-image | `qwen-image`
|
|
111
|
-
| Nano Banana Pro | `gemini-3.0`
|
|
112
|
-
| Nano Banana | `gemini-2.5-flash`
|
|
113
|
-
| Seedream 5.0 Pro | `seedream-5.0-pro`
|
|
114
|
-
| Seedream 5.0 Lite | `seedream-5.0-lite`
|
|
115
|
-
| Seedream 4.5 | `seedream-4.5`
|
|
116
|
-
| Seedream 4.0 | `seedream-4.0`
|
|
117
|
-
| Kling Image O3 | `kling-image-o3`
|
|
118
|
-
| Kling Image V3 | `kling-image-v3`
|
|
113
|
+
| Qwen-image | `qwen-image` | `720p` `1080p` | `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` |
|
|
114
|
+
| Nano Banana Pro | `gemini-3.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
|
|
115
|
+
| Nano Banana | `gemini-2.5-flash` | `1080p` | `auto` `1:1` `16:9` `9:16` + more |
|
|
116
|
+
| Seedream 5.0 Pro | `seedream-5.0-pro` | `1080p` `1440p` | `auto` `1:1` `16:9` `9:16` + more |
|
|
117
|
+
| Seedream 5.0 Lite | `seedream-5.0-lite` | `1440p` `1800p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
|
|
118
|
+
| Seedream 4.5 | `seedream-4.5` | `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
|
|
119
|
+
| Seedream 4.0 | `seedream-4.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
|
|
120
|
+
| Kling Image O3 | `kling-image-o3` | `1080p` `1440p` `2160p` | `16:9` `9:16` `1:1` + more |
|
|
121
|
+
| Kling Image V3 | `kling-image-v3` | `1080p` `1440p` | `16:9` `9:16` `1:1` + more |
|
|
119
122
|
|
|
120
123
|
### Voice / TTS Models (`create voice --model <value>`)
|
|
121
124
|
|
|
@@ -131,10 +134,10 @@ This opens a browser where you confirm the authorization. You can also copy the
|
|
|
131
134
|
|
|
132
135
|
### Music Models (`create music --model <value>`)
|
|
133
136
|
|
|
134
|
-
| Model | `--model` value | Provider | Duration | Notes
|
|
135
|
-
| :---------------------------- | :-------------------- | :--------- | :---------- |
|
|
136
|
-
| MiniMax Music 2.6 _(default)_ | `music-2.6` | MiniMax | `10`-`240`s | Lyrics, auto lyrics, instrumental
|
|
137
|
-
| ElevenLabs Music | `music-v1` | ElevenLabs | `10`-`240`s | Lyrics, auto lyrics, instrumental
|
|
137
|
+
| Model | `--model` value | Provider | Duration | Notes |
|
|
138
|
+
| :---------------------------- | :-------------------- | :--------- | :---------- | :------------------------------------------------------------------ |
|
|
139
|
+
| MiniMax Music 2.6 _(default)_ | `music-2.6` | MiniMax | `10`-`240`s | Lyrics, auto lyrics, instrumental |
|
|
140
|
+
| ElevenLabs Music | `music-v1` | ElevenLabs | `10`-`240`s | Lyrics, auto lyrics, instrumental |
|
|
138
141
|
| Google Lyria 3 Pro | `lyria-3-pro-preview` | Google | `10`-`240`s | Auto lyrics, instrumental, image references, no separate `--lyrics` |
|
|
139
142
|
|
|
140
143
|
> Browse the live music model catalog with `pixverse music models`.
|
|
@@ -160,6 +163,9 @@ Local image inputs larger than `1920x1920` or `5MB` are automatically resized/co
|
|
|
160
163
|
|
|
161
164
|
```bash
|
|
162
165
|
pixverse create video --prompt "A cat walking on Mars" --model v6 --quality 720p --aspect-ratio 16:9
|
|
166
|
+
|
|
167
|
+
# Seedance 2.5 supports integer durations from 4 through 30 seconds
|
|
168
|
+
pixverse create video --prompt "A slow aerial orbit around an alpine lake" --model seedance-2.5 --quality 720p --duration 12 --aspect-ratio 21:9
|
|
163
169
|
```
|
|
164
170
|
|
|
165
171
|
### Text inputs: literal, a file, or stdin
|
|
@@ -183,6 +189,9 @@ pixverse create music --prompt "Bright synth-pop" --lyrics ./lyrics.txt
|
|
|
183
189
|
|
|
184
190
|
```bash
|
|
185
191
|
pixverse create video --prompt "Slow zoom in" --image ./photo.png
|
|
192
|
+
|
|
193
|
+
# Seedance 2.5 image-to-video preserves an explicitly selected fixed ratio
|
|
194
|
+
pixverse create video --prompt "The subject turns toward the camera" --image ./portrait.png --model seedance-2.5 --aspect-ratio 4:3
|
|
186
195
|
```
|
|
187
196
|
|
|
188
197
|
### Text to Image
|
|
@@ -203,6 +212,9 @@ pixverse create image --prompt "Turn this into a watercolor painting" --image ./
|
|
|
203
212
|
# Create a transition between keyframes (requires 2+ images)
|
|
204
213
|
pixverse create transition --images ./frame1.png ./frame2.png ./frame3.png
|
|
205
214
|
|
|
215
|
+
# Seedance 2.5 transition requires exactly 2 frames; do not pass --aspect-ratio
|
|
216
|
+
pixverse create transition -m seedance-2.5 --images ./first.png ./last.png --prompt "A seamless transformation"
|
|
217
|
+
|
|
206
218
|
# Generate speech audio from text (text-to-speech)
|
|
207
219
|
pixverse create voice --text "Hello world" --voice-id <preset_voice_id> --output ./out.mp3
|
|
208
220
|
# Browse available models / preset voices:
|
|
@@ -232,6 +244,10 @@ pixverse create upscale --video <video_id> --quality 2160p
|
|
|
232
244
|
# Generate video with character reference (1–7 images)
|
|
233
245
|
pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park"
|
|
234
246
|
|
|
247
|
+
# Seedance 2.5 reference — up to 50 total inputs: 30 images, 10 videos, and 10 audios;
|
|
248
|
+
# 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"
|
|
250
|
+
|
|
235
251
|
# Seedance 2.0 reference — mix images and videos (max 3 videos, total ≤ 15s)
|
|
236
252
|
pixverse create reference -m seedance-2.0-standard --images ./char.png --videos ./motion.mp4 --prompt "@image1 follows the motion in @video1"
|
|
237
253
|
|
|
@@ -269,6 +285,8 @@ These flags are available across most `create` subcommands:
|
|
|
269
285
|
| `--no-wait` | Return immediately without waiting for completion |
|
|
270
286
|
| `--timeout <sec>` | Polling timeout in seconds (default 300) |
|
|
271
287
|
|
|
288
|
+
> Model-specific support still applies. Seedance 2.5 does not support `--audio`, `--multi-shot`, or `--off-peak`. Its `--audios` values in `create reference` are input references, not a generated-audio toggle.
|
|
289
|
+
|
|
272
290
|
### MiniApps
|
|
273
291
|
|
|
274
292
|
MiniApps are preset, single-purpose generators from the PixVerse web app (Magic
|
|
@@ -482,16 +500,16 @@ pixverse asset download "$VID" --dest ./output/
|
|
|
482
500
|
|
|
483
501
|
### Exit Codes
|
|
484
502
|
|
|
485
|
-
| Code | Meaning
|
|
486
|
-
| :--- |
|
|
487
|
-
| `0` | Success
|
|
488
|
-
| `1` | General error
|
|
489
|
-
| `2` | Timeout
|
|
490
|
-
| `3` | Authentication error
|
|
491
|
-
| `4` | Credit / subscription limit
|
|
492
|
-
| `5` | Generation failed
|
|
493
|
-
| `6` | Validation error
|
|
494
|
-
| `7` | Concurrent generation limit; wait for a slot and retry
|
|
503
|
+
| Code | Meaning |
|
|
504
|
+
| :--- | :----------------------------------------------------- |
|
|
505
|
+
| `0` | Success |
|
|
506
|
+
| `1` | General error |
|
|
507
|
+
| `2` | Timeout |
|
|
508
|
+
| `3` | Authentication error |
|
|
509
|
+
| `4` | Credit / subscription limit |
|
|
510
|
+
| `5` | Generation failed |
|
|
511
|
+
| `6` | Validation error |
|
|
512
|
+
| `7` | Concurrent generation limit; wait for a slot and retry |
|
|
495
513
|
|
|
496
514
|
## All Commands
|
|
497
515
|
|
|
@@ -518,7 +536,7 @@ pixverse asset download "$VID" --dest ./output/
|
|
|
518
536
|
| `voice models` | List voice/TTS providers, models, and supported languages |
|
|
519
537
|
| `voice presets` | List preset voices (filterable by model / language / provider) |
|
|
520
538
|
| `music models` | List music providers, models, and capabilities |
|
|
521
|
-
| `task status` | Check one ID or batch with space-separated IDs / `--ids id1,id2,...`
|
|
539
|
+
| `task status` | Check one ID or batch with space-separated IDs / `--ids id1,id2,...` |
|
|
522
540
|
| `task wait` | Wait for task completion |
|
|
523
541
|
| `asset list` | List assets (`--source create\|upload`, `--type video\|image\|audio`, `--off-peak`) |
|
|
524
542
|
| `asset upload` | Upload a local file or HTTPS URL to asset library |
|
package/dist/capabilities.json
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"cli": {
|
|
6
6
|
"name": "pixverse",
|
|
7
7
|
"package": "pixverse",
|
|
8
|
-
"version": "1.3.
|
|
8
|
+
"version": "1.3.1",
|
|
9
9
|
"binary": "pixverse",
|
|
10
10
|
"node": ">=20",
|
|
11
11
|
"description": "PixVerse CLI - generate videos and images from the command line"
|
|
@@ -300,9 +300,9 @@
|
|
|
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 (
|
|
304
|
-
"--videos <inputs...>": "Video reference inputs (
|
|
305
|
-
"--audios <inputs...>": "Audio reference inputs (
|
|
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)",
|
|
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",
|