pixverse 1.2.9 → 1.2.11

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 (4) hide show
  1. package/README.md +25 -15
  2. package/dist/capabilities.json +21 -71
  3. package/dist/index.js +1 -1
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -62,6 +62,7 @@ This opens a browser where you confirm the authorization. You can also copy the
62
62
  | 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
63
  | 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
64
  | 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 | `minimax-h3` | `1440p` | `5`–`15`s | `auto` `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` |
65
66
  | Google Gemini Omni | `gemini-omni-flash` | `720p` | `3`–`10`s | `16:9` `9:16` |
66
67
  | Happy Horse 1.0 | `happyhorse-1.0` | `720p` `1080p` | `3`–`15`s | `16:9` `9:16` `1:1` `4:3` `3:4` |
67
68
  | Kling O3 Pro | `kling-o3-pro` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
@@ -79,6 +80,8 @@ This opens a browser where you confirm the authorization. You can also copy the
79
80
  | 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` |
80
81
  | 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` |
81
82
 
83
+ > MiniMax H3 supports `auto` only when an image is supplied. Text-to-video defaults to `16:9`.
84
+
82
85
  > 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).
83
86
 
84
87
  > Not all models support all creation modes. See the per-mode support matrix below.
@@ -87,10 +90,10 @@ This opens a browser where you confirm the authorization. You can also copy the
87
90
 
88
91
  | Creation mode | Supported `--model` values |
89
92
  | :---------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
90
- | `create video` (text-to-video / image-to-video) | `v6` `pixverse-c1` `seedance-2.0-standard` `seedance-2.0-fast` `seedance-2.0-mini` `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` |
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` |
91
94
  | `create extend` | `v6` `grok-imagine` |
92
- | `create reference` (multi-subject reference) | `v6` `pixverse-c1` `seedance-2.0-standard` `seedance-2.0-fast` `seedance-2.0-mini` `gemini-omni-flash` `kling-o3-pro` `kling-o3-standard` `grok-imagine` `v5.6` |
93
- | `create transition` (2 frames) | `v6` `pixverse-c1` `seedance-2.0-standard` `seedance-2.0-fast` `seedance-2.0-mini` `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` |
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` |
94
97
  | `create transition` (3+ frames) | `v5` |
95
98
  | `create modify` | `v5.5` |
96
99
  | `create motion-control` | `v5.6` |
@@ -224,7 +227,7 @@ pixverse create extend --video <video_id>
224
227
  pixverse create modify --video <video_id> --prompt "Change the background to a beach"
225
228
 
226
229
  # Upscale video resolution
227
- pixverse create upscale --video <video_id> --quality 1080p
230
+ pixverse create upscale --video <video_id> --quality 2160p
228
231
 
229
232
  # Generate video with character reference (1–7 images)
230
233
  pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park"
@@ -235,6 +238,9 @@ pixverse create reference -m seedance-2.0-standard --images ./char.png --videos
235
238
  # Seedance 2.0 reference — add audio references (max 3, each 2–15s, total ≤ 15s; needs a visual reference)
236
239
  pixverse create reference -m seedance-2.0-standard --images ./char.png --audios ./voice.mp3 --prompt "@image1 speaks the line in @audio1"
237
240
 
241
+ # MiniMax H3 reference — mix up to 9 images, 3 videos, and 3 audios
242
+ pixverse create reference -m minimax-h3 --images ./char.png --videos ./motion.mp4 --audios ./voice.mp3 --prompt "@image1 follows @video1 and @audio1"
243
+
238
244
  # Motion control — character image + motion reference video
239
245
  pixverse create motion-control --image ./character.png --video ./dance.mp4
240
246
 
@@ -272,7 +278,10 @@ pixverse task status <id>
272
278
  # Poll a voice/music audio task (audio is not auto-detected — pass --type audio)
273
279
  pixverse task status <id> --type audio
274
280
 
275
- # Batch status query (parallel; per-ID failures captured in the response map)
281
+ # Batch status query with space-separated IDs (parallel; per-ID failures captured)
282
+ pixverse task status 123 456 789 --type video --json
283
+
284
+ # Comma-separated batch syntax remains supported
276
285
  pixverse task status --ids 123,456,789 --type video --json
277
286
 
278
287
  # Wait for a task to complete
@@ -436,15 +445,16 @@ pixverse asset download "$VID" --dest ./output/
436
445
 
437
446
  ### Exit Codes
438
447
 
439
- | Code | Meaning |
440
- | :--- | :-------------------------- |
441
- | `0` | Success |
442
- | `1` | General error |
443
- | `2` | Timeout |
444
- | `3` | Authentication error |
445
- | `4` | Credit / subscription limit |
446
- | `5` | Generation failed |
447
- | `6` | Validation error |
448
+ | Code | Meaning |
449
+ | :--- | :--------------------------------------------------------- |
450
+ | `0` | Success |
451
+ | `1` | General error |
452
+ | `2` | Timeout |
453
+ | `3` | Authentication error |
454
+ | `4` | Credit / subscription limit |
455
+ | `5` | Generation failed |
456
+ | `6` | Validation error |
457
+ | `7` | Concurrent generation limit; wait for a slot and retry |
448
458
 
449
459
  ## All Commands
450
460
 
@@ -471,7 +481,7 @@ pixverse asset download "$VID" --dest ./output/
471
481
  | `voice models` | List voice/TTS providers, models, and supported languages |
472
482
  | `voice presets` | List preset voices (filterable by model / language / provider) |
473
483
  | `music models` | List music providers, models, and capabilities |
474
- | `task status` | Check task status (single `<id>` or `--ids id1,id2,...` for batch) |
484
+ | `task status` | Check one ID or batch with space-separated IDs / `--ids id1,id2,...` |
475
485
  | `task wait` | Wait for task completion |
476
486
  | `asset list` | List assets (`--source create\|upload`, `--type video\|image\|audio`, `--off-peak`) |
477
487
  | `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.2.9",
8
+ "version": "1.2.11",
9
9
  "binary": "pixverse",
10
10
  "node": ">=20",
11
11
  "description": "PixVerse CLI - generate videos and images from the command line"
@@ -24,7 +24,8 @@
24
24
  "3": "AUTH_EXPIRED: authentication token invalid or expired",
25
25
  "4": "CREDIT_INSUFFICIENT: subscription or credit limit",
26
26
  "5": "GENERATION_FAILED: generation failed or was not approved",
27
- "6": "VALIDATION_ERROR: CLI input validation error"
27
+ "6": "VALIDATION_ERROR: CLI input validation error",
28
+ "7": "CONCURRENCY_LIMIT: concurrent generation limit; wait for a slot and retry"
28
29
  },
29
30
  "global_options": {
30
31
  "-V, --version": "output the version number",
@@ -63,11 +64,7 @@
63
64
  {
64
65
  "cmd": "pixverse auth",
65
66
  "desc": "Manage authentication",
66
- "children": [
67
- "login",
68
- "status",
69
- "logout"
70
- ]
67
+ "children": ["login", "status", "logout"]
71
68
  },
72
69
  {
73
70
  "cmd": "pixverse auth login",
@@ -282,13 +279,13 @@
282
279
  },
283
280
  {
284
281
  "cmd": "pixverse create upscale",
285
- "desc": "Upscale video resolution",
282
+ "desc": "Upscale video resolution to 2160p",
286
283
  "run": true,
287
284
  "auth": true,
288
285
  "effect": "creates_remote_media_asset",
289
286
  "options": {
290
287
  "--video <input>": "Video input: file path, HTTPS URL, video ID, or media path",
291
- "-q, --quality <quality>": "Target quality (e.g. 1080p)",
288
+ "-q, --quality <quality>": "Target quality | default: 2160p | choices: 2160p",
292
289
  "--idempotency-key <key>": "Idempotency key for safe retry - backend dedupes by key so repeated submissions return the original task without re-charging",
293
290
  "--no-wait": "Return immediately without polling | negates: wait",
294
291
  "--timeout <seconds>": "Polling timeout in seconds | default: 300",
@@ -302,9 +299,9 @@
302
299
  "auth": true,
303
300
  "effect": "creates_remote_media_asset",
304
301
  "options": {
305
- "--images <inputs...>": "Image inputs: file paths, HTTPS URLs, image IDs, or media paths (1-7, up to 9 for seedance-2.0, max 5 for gemini-omni-flash; local oversized images are auto-resized to fit 1920x1920)",
306
- "--videos <inputs...>": "Video reference inputs (seedance-2.0 only): file paths, HTTPS URLs, video IDs, or media paths (max 3, total duration ≤ 15s)",
307
- "--audios <inputs...>": "Audio reference inputs (seedance-2.0 only): file paths, HTTPS URLs, audio IDs, or media paths (max 3, each 2–15s, total ≤ 15s; requires at least one image or video reference)",
302
+ "--images <inputs...>": "Image inputs: file paths, HTTPS URLs, image IDs, or media paths (1-7, up to 9 for seedance-2.0 and minimax-h3, max 5 for gemini-omni-flash; local oversized images are auto-resized to fit 1920x1920)",
303
+ "--videos <inputs...>": "Video reference inputs (seedance-2.0 and minimax-h3): file paths, HTTPS URLs, video IDs, or media paths (max 3; seedance total duration ≤ 15s)",
304
+ "--audios <inputs...>": "Audio reference inputs (seedance-2.0 and minimax-h3): file paths, HTTPS URLs, audio IDs, or media paths (max 3; seedance clips must be 2–15s and total ≤ 15s; requires at least one image or video reference)",
308
305
  "--prompt <text>": "Prompt text",
309
306
  "-m, --model <model>": "Video model",
310
307
  "-q, --quality <quality>": "Video quality",
@@ -366,10 +363,7 @@
366
363
  {
367
364
  "cmd": "pixverse task",
368
365
  "desc": "Manage generation tasks",
369
- "children": [
370
- "status",
371
- "wait"
372
- ]
366
+ "children": ["status", "wait"]
373
367
  },
374
368
  {
375
369
  "cmd": "pixverse task status",
@@ -377,7 +371,7 @@
377
371
  "run": true,
378
372
  "auth": true,
379
373
  "args": {
380
- "id?": "Single video, image, or audio ID (omit when using --ids)"
374
+ "ids...": "One or more space-separated video, image, or audio IDs (omit when using --ids)"
381
375
  },
382
376
  "options": {
383
377
  "--ids <ids>": "Comma-separated list of IDs for batch query (e.g. 123,456,789)",
@@ -402,13 +396,7 @@
402
396
  {
403
397
  "cmd": "pixverse asset",
404
398
  "desc": "Manage your generated assets",
405
- "children": [
406
- "list",
407
- "info",
408
- "download",
409
- "upload",
410
- "delete"
411
- ]
399
+ "children": ["list", "info", "download", "upload", "delete"]
412
400
  },
413
401
  {
414
402
  "cmd": "pixverse asset list",
@@ -484,11 +472,7 @@
484
472
  {
485
473
  "cmd": "pixverse account",
486
474
  "desc": "View account info and credit usage",
487
- "children": [
488
- "info",
489
- "usage",
490
- "slots"
491
- ]
475
+ "children": ["info", "usage", "slots"]
492
476
  },
493
477
  {
494
478
  "cmd": "pixverse account info",
@@ -532,14 +516,7 @@
532
516
  {
533
517
  "cmd": "pixverse config",
534
518
  "desc": "Manage CLI configuration",
535
- "children": [
536
- "list",
537
- "get",
538
- "set",
539
- "reset",
540
- "path",
541
- "defaults"
542
- ]
519
+ "children": ["list", "get", "set", "reset", "path", "defaults"]
543
520
  },
544
521
  {
545
522
  "cmd": "pixverse config list",
@@ -593,11 +570,7 @@
593
570
  "cmd": "pixverse config defaults",
594
571
  "desc": "Manage per-mode creation default parameters",
595
572
  "run": true,
596
- "children": [
597
- "show",
598
- "set",
599
- "reset"
600
- ]
573
+ "children": ["show", "set", "reset"]
601
574
  },
602
575
  {
603
576
  "cmd": "pixverse config defaults show",
@@ -640,12 +613,7 @@
640
613
  {
641
614
  "cmd": "pixverse template",
642
615
  "desc": "Browse and manage templates",
643
- "children": [
644
- "categories",
645
- "list",
646
- "search",
647
- "info"
648
- ]
616
+ "children": ["categories", "list", "search", "info"]
649
617
  },
650
618
  {
651
619
  "cmd": "pixverse template categories",
@@ -695,10 +663,7 @@
695
663
  {
696
664
  "cmd": "pixverse voice",
697
665
  "desc": "Browse voice/TTS models and preset voices",
698
- "children": [
699
- "models",
700
- "presets"
701
- ]
666
+ "children": ["models", "presets"]
702
667
  },
703
668
  {
704
669
  "cmd": "pixverse voice models",
@@ -726,9 +691,7 @@
726
691
  {
727
692
  "cmd": "pixverse music",
728
693
  "desc": "Browse music generation models",
729
- "children": [
730
- "models"
731
- ]
694
+ "children": ["models"]
732
695
  },
733
696
  {
734
697
  "cmd": "pixverse music models",
@@ -742,15 +705,7 @@
742
705
  {
743
706
  "cmd": "pixverse saved",
744
707
  "desc": "Manage saved folders and their contents",
745
- "children": [
746
- "list",
747
- "items",
748
- "new",
749
- "rename",
750
- "add",
751
- "remove",
752
- "delete"
753
- ]
708
+ "children": ["list", "items", "new", "rename", "add", "remove", "delete"]
754
709
  },
755
710
  {
756
711
  "cmd": "pixverse saved list",
@@ -853,13 +808,8 @@
853
808
  },
854
809
  {
855
810
  "cmd": "pixverse workspace",
856
- "desc": "Manage workspaces (list, switch, view current)",
857
- "children": [
858
- "list",
859
- "status",
860
- "switch",
861
- "manage"
862
- ]
811
+ "desc": "Manage workspaces (list, switch, status)",
812
+ "children": ["list", "status", "switch", "manage"]
863
813
  },
864
814
  {
865
815
  "cmd": "pixverse workspace list",