pixverse-ai-cli 1.2.0 → 1.2.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
@@ -55,27 +55,27 @@ This opens a browser where you confirm the authorization. You can also copy the
55
55
 
56
56
  ### Video Models (`--model <value>`)
57
57
 
58
- | Model | `--model` value | Quality | Duration | Aspect Ratio |
59
- |:---|:---|:---|:---|:---|
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
- | 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.0 Standard | `seedance-2.0-standard` | `480p` `720p` `1080p` | `4`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` |
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
- | Happy Horse 1.0 | `happyhorse-1.0` | `720p` `1080p` | `3`–`15`s | `16:9` `9:16` `1:1` `4:3` `3:4` |
65
- | Kling O3 Pro | `kling-o3-pro` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
66
- | Kling O3 Standard | `kling-o3-standard` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
67
- | Kling 3.0 Pro | `kling-3.0-pro` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
68
- | Kling 3.0 Standard | `kling-3.0-standard` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
69
- | Grok Imagine 1.5 | `grok-imagine-1.5` | `480p` `720p` | `1`–`15`s | *from image* |
70
- | Grok Imagine | `grok-imagine` | `480p` `720p` | `1`–`15`s | `16:9` `4:3` `1:1` `9:16` `3:4` `3:2` `2:3` |
71
- | Veo 3.1 Lite | `veo-3.1-lite` | `720p` `1080p` | `4` `6` `8`s | `16:9` `9:16` |
72
- | Veo 3.1 Standard | `veo-3.1-standard` | `720p` `1080p` `2160p` | `4` `6` `8`s | `16:9` `9:16` |
73
- | Veo 3.1 Fast | `veo-3.1-fast` | `720p` `1080p` `2160p` | `4` `6` `8`s | `16:9` `9:16` |
74
- | Sora 2 Pro | `sora-2-pro` | `720p` `1080p` | `4` `8` `12`s | `16:9` `9:16` |
75
- | Sora 2 | `sora-2` | `720p` | `4` `8` `12`s | `16:9` `9:16` |
76
- | PixVerse v5.6 | `v5.6` | `360p` `480p` `540p` `720p` `1080p` | `1`–`10`s | `16:9` `4:3` `1:1` `3:4` `9:16` `3:2` `2:3` |
77
- | 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` |
78
- | 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` |
58
+ | Model | `--model` value | Quality | Duration | Aspect Ratio |
59
+ | :---------------------- | :---------------------- | :---------------------------------- | :------------ | :------------------------------------------------- |
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
+ | 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.0 Standard | `seedance-2.0-standard` | `480p` `720p` `1080p` | `4`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` |
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
+ | Happy Horse 1.0 | `happyhorse-1.0` | `720p` `1080p` | `3`–`15`s | `16:9` `9:16` `1:1` `4:3` `3:4` |
65
+ | Kling O3 Pro | `kling-o3-pro` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
66
+ | Kling O3 Standard | `kling-o3-standard` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
67
+ | Kling 3.0 Pro | `kling-3.0-pro` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
68
+ | Kling 3.0 Standard | `kling-3.0-standard` | `720p` | `3`–`15`s | `16:9` `9:16` `1:1` |
69
+ | Grok Imagine 1.5 | `grok-imagine-1.5` | `480p` `720p` | `1`–`15`s | _from image_ |
70
+ | Grok Imagine | `grok-imagine` | `480p` `720p` | `1`–`15`s | `16:9` `4:3` `1:1` `9:16` `3:4` `3:2` `2:3` |
71
+ | Veo 3.1 Lite | `veo-3.1-lite` | `720p` `1080p` | `4` `6` `8`s | `16:9` `9:16` |
72
+ | Veo 3.1 Standard | `veo-3.1-standard` | `720p` `1080p` `2160p` | `4` `6` `8`s | `16:9` `9:16` |
73
+ | Veo 3.1 Fast | `veo-3.1-fast` | `720p` `1080p` `2160p` | `4` `6` `8`s | `16:9` `9:16` |
74
+ | Sora 2 Pro | `sora-2-pro` | `720p` `1080p` | `4` `8` `12`s | `16:9` `9:16` |
75
+ | Sora 2 | `sora-2` | `720p` | `4` `8` `12`s | `16:9` `9:16` |
76
+ | PixVerse v5.6 | `v5.6` | `360p` `480p` `540p` `720p` `1080p` | `1`–`10`s | `16:9` `4:3` `1:1` `3:4` `9:16` `3:2` `2:3` |
77
+ | 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` |
78
+ | 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` |
79
79
 
80
80
  > 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).
81
81
 
@@ -83,52 +83,52 @@ This opens a browser where you confirm the authorization. You can also copy the
83
83
 
84
84
  #### Per-mode Model Support
85
85
 
86
- | Creation mode | Supported `--model` values |
87
- |:---|:---|
86
+ | Creation mode | Supported `--model` values |
87
+ | :---------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
88
88
  | `create video` (text-to-video / image-to-video) | `v6` `pixverse-c1` `seedance-2.0-standard` `seedance-2.0-fast` `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` |
89
- | `create extend` | `v6` `grok-imagine` |
90
- | `create reference` (multi-subject fusion) | `v6` `pixverse-c1` `seedance-2.0-standard` `seedance-2.0-fast` `kling-o3-pro` `kling-o3-standard` `grok-imagine` `v5.6` |
91
- | `create transition` (2 frames) | `v6` `pixverse-c1` `seedance-2.0-standard` `seedance-2.0-fast` `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` |
92
- | `create transition` (3+ frames) | `v5` |
93
- | `create modify` | `v5.5` |
94
- | `create motion-control` | `v5.6` |
89
+ | `create extend` | `v6` `grok-imagine` |
90
+ | `create reference` (multi-subject reference) | `v6` `pixverse-c1` `seedance-2.0-standard` `seedance-2.0-fast` `kling-o3-pro` `kling-o3-standard` `grok-imagine` `v5.6` |
91
+ | `create transition` (2 frames) | `v6` `pixverse-c1` `seedance-2.0-standard` `seedance-2.0-fast` `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` |
92
+ | `create transition` (3+ frames) | `v5` |
93
+ | `create modify` | `v5.5` |
94
+ | `create motion-control` | `v5.6` |
95
95
 
96
96
  > Audio creation uses separate model families: `create voice` for text-to-speech and `create music` for prompt-to-music.
97
97
 
98
98
  ### Image Models (`--model <value>`)
99
99
 
100
- | Model | `--model` value | Quality | Aspect Ratio |
101
- |:---|:---|:---|:---|
102
- | 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` |
103
- | Nano Banana 2 | `gemini-3.1-flash` | `512p` `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
104
- | 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` |
105
- | Nano Banana Pro | `gemini-3.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
106
- | Nano Banana | `gemini-2.5-flash` | `1080p` | `auto` `1:1` `16:9` `9:16` + more |
107
- | Seedream 5.0 Lite | `seedream-5.0-lite` | `1440p` `1800p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
108
- | Seedream 4.5 | `seedream-4.5` | `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
109
- | Seedream 4.0 | `seedream-4.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
110
- | Kling Image O3 | `kling-image-o3` | `1080p` `1440p` `2160p` | `16:9` `9:16` `1:1` + more |
111
- | Kling Image V3 | `kling-image-v3` | `1080p` `1440p` | `16:9` `9:16` `1:1` + more |
100
+ | Model | `--model` value | Quality | Aspect Ratio |
101
+ | :---------------------- | :------------------ | :----------------------------- | :------------------------------------------------------------- |
102
+ | 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` |
103
+ | Nano Banana 2 | `gemini-3.1-flash` | `512p` `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
104
+ | 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` |
105
+ | Nano Banana Pro | `gemini-3.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
106
+ | Nano Banana | `gemini-2.5-flash` | `1080p` | `auto` `1:1` `16:9` `9:16` + more |
107
+ | Seedream 5.0 Lite | `seedream-5.0-lite` | `1440p` `1800p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
108
+ | Seedream 4.5 | `seedream-4.5` | `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
109
+ | Seedream 4.0 | `seedream-4.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
110
+ | Kling Image O3 | `kling-image-o3` | `1080p` `1440p` `2160p` | `16:9` `9:16` `1:1` + more |
111
+ | Kling Image V3 | `kling-image-v3` | `1080p` `1440p` | `16:9` `9:16` `1:1` + more |
112
112
 
113
113
  ### Voice / TTS Models (`create voice --model <value>`)
114
114
 
115
- | Model | `--model` value | Provider | Max characters |
116
- |:---|:---|:---|:---|
117
- | MiniMax Speech 2.8 HD *(default)* | `speech-2.8-hd` | MiniMax | 10,000 |
118
- | MiniMax Speech 2.8 Turbo | `speech-2.8-turbo` | MiniMax | 10,000 |
119
- | Eleven Multilingual v2 | `eleven-multilingual-v2` | ElevenLabs | 10,000 |
120
- | Eleven v3 | `eleven-v3` | ElevenLabs | 5,000 |
121
- | Eleven Turbo v2.5 | `eleven-turbo-v2.5` | ElevenLabs | 40,000 |
115
+ | Model | `--model` value | Provider | Max characters |
116
+ | :-------------------------------- | :----------------------- | :--------- | :------------- |
117
+ | MiniMax Speech 2.8 HD _(default)_ | `speech-2.8-hd` | MiniMax | 10,000 |
118
+ | MiniMax Speech 2.8 Turbo | `speech-2.8-turbo` | MiniMax | 10,000 |
119
+ | Eleven Multilingual v2 | `eleven-multilingual-v2` | ElevenLabs | 10,000 |
120
+ | Eleven v3 | `eleven-v3` | ElevenLabs | 5,000 |
121
+ | Eleven Turbo v2.5 | `eleven-turbo-v2.5` | ElevenLabs | 40,000 |
122
122
 
123
123
  > Browse available preset voices with `pixverse voice presets --model <id>` and the full live model catalog with `pixverse voice models`.
124
124
 
125
125
  ### Music Models (`create music --model <value>`)
126
126
 
127
- | Model | `--model` value | Provider | Duration | Notes |
128
- |:---|:---|:---|:---|:---|
129
- | MiniMax Music 2.6 *(default)* | `music-2.6` | MiniMax | `10`-`240`s | Lyrics, auto lyrics, instrumental |
130
- | ElevenLabs Music | `music_v1` | ElevenLabs | `10`-`240`s | Lyrics, auto lyrics, instrumental |
131
- | Google Lyria 3 Pro | `lyria-3-pro-preview` | Google | `10`-`240`s | Image references, no separate `--lyrics` |
127
+ | Model | `--model` value | Provider | Duration | Notes |
128
+ | :---------------------------- | :-------------------- | :--------- | :---------- | :--------------------------------------- |
129
+ | MiniMax Music 2.6 _(default)_ | `music-2.6` | MiniMax | `10`-`240`s | Lyrics, auto lyrics, instrumental |
130
+ | ElevenLabs Music | `music-v1` | ElevenLabs | `10`-`240`s | Lyrics, auto lyrics, instrumental |
131
+ | Google Lyria 3 Pro | `lyria-3-pro-preview` | Google | `10`-`240`s | Image references, no separate `--lyrics` |
132
132
 
133
133
  > Browse the live music model catalog with `pixverse music models`.
134
134
 
@@ -237,24 +237,24 @@ pixverse create template --template-id 12345 --image ./photo.png
237
237
 
238
238
  Voice speed uses provider-specific validation:
239
239
 
240
- | Provider | Default | Valid range | Invalid range error | Provider request field |
241
- |:---|:---|:---|:---|:---|
242
- | ElevenLabs | `1.0` | `0.7..1.2` | `--speed must be between 0.7 and 1.2` | `voice_settings.speed` |
243
- | MiniMax | `1.0` | `0.5..2.0` | `--speed must be between 0.5 and 2` | `voice_setting.speed` |
240
+ | Provider | Default | Valid range | Invalid range error | Provider request field |
241
+ | :--------- | :------ | :---------- | :------------------------------------ | :--------------------- |
242
+ | ElevenLabs | `1.0` | `0.7..1.2` | `--speed must be between 0.7 and 1.2` | `voice_settings.speed` |
243
+ | MiniMax | `1.0` | `0.5..2.0` | `--speed must be between 0.5 and 2` | `voice_setting.speed` |
244
244
 
245
245
  ### Common Creation Flags
246
246
 
247
247
  These flags are available across most `create` subcommands:
248
248
 
249
- | Flag | Description |
250
- |:---|:---|
251
- | `--count <n>` | Generate multiple variations (1–4, default 1) |
252
- | `--seed <number>` | Set random seed for reproducible results |
253
- | `--off-peak` | Use off-peak pricing (lower credit cost) |
254
- | `--audio` / `--no-audio` | Enable or disable audio generation |
255
- | `--multi-shot` / `--no-multi-shot` | Enable or disable multi-shot mode (video only) |
256
- | `--no-wait` | Return immediately without waiting for completion |
257
- | `--timeout <sec>` | Polling timeout in seconds (default 300) |
249
+ | Flag | Description |
250
+ | :--------------------------------- | :------------------------------------------------ |
251
+ | `--count <n>` | Generate multiple variations (1–4, default 1) |
252
+ | `--seed <number>` | Set random seed for reproducible results |
253
+ | `--off-peak` | Use off-peak pricing (lower credit cost) |
254
+ | `--audio` / `--no-audio` | Enable or disable audio generation |
255
+ | `--multi-shot` / `--no-multi-shot` | Enable or disable multi-shot mode (video only) |
256
+ | `--no-wait` | Return immediately without waiting for completion |
257
+ | `--timeout <sec>` | Polling timeout in seconds (default 300) |
258
258
 
259
259
  ### Task Management
260
260
 
@@ -429,80 +429,80 @@ pixverse asset download "$VID" --dest ./output/
429
429
 
430
430
  ### Exit Codes
431
431
 
432
- | Code | Meaning |
433
- |:---|:---|
434
- | `0` | Success |
435
- | `1` | General error |
436
- | `2` | Timeout |
437
- | `3` | Authentication error |
438
- | `4` | Credit / subscription limit |
439
- | `5` | Generation failed |
440
- | `6` | Validation error |
432
+ | Code | Meaning |
433
+ | :--- | :-------------------------- |
434
+ | `0` | Success |
435
+ | `1` | General error |
436
+ | `2` | Timeout |
437
+ | `3` | Authentication error |
438
+ | `4` | Credit / subscription limit |
439
+ | `5` | Generation failed |
440
+ | `6` | Validation error |
441
441
 
442
442
  ## All Commands
443
443
 
444
- | Command | Description |
445
- |:---|:---|
446
- | `auth login` | Login via browser (OAuth device flow) |
447
- | `auth status` | Check authentication status |
448
- | `auth logout` | Remove stored token |
449
- | `create video` | Text-to-video or image-to-video |
450
- | `create image` | Text-to-image or image-to-image |
451
- | `create transition` | Create transitions between keyframes |
452
- | `create voice` | Generate speech audio from text (text-to-speech) |
453
- | `create music` | Generate music audio from a prompt |
454
- | `create extend` | Extend video duration |
455
- | `create modify` | Modify an existing video |
456
- | `create upscale` | Upscale video resolution |
457
- | `create reference` | Generate video with character references |
458
- | `create motion-control` | Motion control with character image + reference video |
459
- | `create template` | Create from a template/effect |
460
- | `template categories` | List template categories |
461
- | `template list` | List templates (with category filter) |
462
- | `template search` | Search templates by keyword |
463
- | `template info` | Get template details |
464
- | `voice models` | List voice/TTS providers, models, and supported languages |
465
- | `voice presets` | List preset voices (filterable by model / language / provider) |
466
- | `music models` | List music providers, models, and capabilities |
467
- | `task status` | Check task status (single `<id>` or `--ids id1,id2,...` for batch) |
468
- | `task wait` | Wait for task completion |
469
- | `asset list` | List assets (`--source create\|upload`, `--type video\|image\|audio`, `--off-peak`) |
470
- | `asset upload` | Upload a local file or HTTPS URL to asset library |
471
- | `asset info` | Get asset details |
472
- | `asset download` | Download a generated asset |
473
- | `asset delete` | Delete an asset |
474
- | `saved list` | List saved folders |
475
- | `saved items` | List items in a saved folder |
476
- | `saved new` | Create a new saved folder |
477
- | `saved rename` | Rename a saved folder |
478
- | `saved add` | Add assets to a saved folder |
479
- | `saved remove` | Remove assets from a saved folder |
480
- | `saved delete` | Delete a saved folder |
481
- | `workspace list` | List all workspaces |
482
- | `workspace status` | Show current workspace |
483
- | `workspace switch` | Switch workspace (interactive or by ID) |
484
- | `workspace manage` | Open workspace management in browser |
485
- | `account info` | View account info and workspace credits |
486
- | `account usage` | View credit usage |
487
- | `account slots` | View current concurrent generation slots (image / video) |
488
- | `subscribe` | Open subscription page |
489
- | `update` | Update the CLI to the latest version (`npm i -g pixverse@latest`) |
490
- | `config set` | Set a config value |
491
- | `config get` | Get a config value |
492
- | `config list` | List all config values |
493
- | `config reset` | Reset config to defaults |
494
- | `config path` | Show config file path |
495
- | `config defaults` | Manage per-mode creation defaults |
444
+ | Command | Description |
445
+ | :---------------------- | :---------------------------------------------------------------------------------- |
446
+ | `auth login` | Login via browser (OAuth device flow) |
447
+ | `auth status` | Check authentication status |
448
+ | `auth logout` | Remove stored token |
449
+ | `create video` | Text-to-video or image-to-video |
450
+ | `create image` | Text-to-image or image-to-image |
451
+ | `create transition` | Create transitions between keyframes |
452
+ | `create voice` | Generate speech audio from text (text-to-speech) |
453
+ | `create music` | Generate music audio from a prompt |
454
+ | `create extend` | Extend video duration |
455
+ | `create modify` | Modify an existing video |
456
+ | `create upscale` | Upscale video resolution |
457
+ | `create reference` | Generate video with character references |
458
+ | `create motion-control` | Motion control with character image + reference video |
459
+ | `create template` | Create from a template/effect |
460
+ | `template categories` | List template categories |
461
+ | `template list` | List templates (with category filter) |
462
+ | `template search` | Search templates by keyword |
463
+ | `template info` | Get template details |
464
+ | `voice models` | List voice/TTS providers, models, and supported languages |
465
+ | `voice presets` | List preset voices (filterable by model / language / provider) |
466
+ | `music models` | List music providers, models, and capabilities |
467
+ | `task status` | Check task status (single `<id>` or `--ids id1,id2,...` for batch) |
468
+ | `task wait` | Wait for task completion |
469
+ | `asset list` | List assets (`--source create\|upload`, `--type video\|image\|audio`, `--off-peak`) |
470
+ | `asset upload` | Upload a local file or HTTPS URL to asset library |
471
+ | `asset info` | Get asset details |
472
+ | `asset download` | Download a generated asset |
473
+ | `asset delete` | Delete an asset |
474
+ | `saved list` | List saved folders |
475
+ | `saved items` | List items in a saved folder |
476
+ | `saved new` | Create a new saved folder |
477
+ | `saved rename` | Rename a saved folder |
478
+ | `saved add` | Add assets to a saved folder |
479
+ | `saved remove` | Remove assets from a saved folder |
480
+ | `saved delete` | Delete a saved folder |
481
+ | `workspace list` | List all workspaces |
482
+ | `workspace status` | Show current workspace |
483
+ | `workspace switch` | Switch workspace (interactive or by ID) |
484
+ | `workspace manage` | Open workspace management in browser |
485
+ | `account info` | View account info and workspace credits |
486
+ | `account usage` | View credit usage |
487
+ | `account slots` | View current concurrent generation slots (image / video) |
488
+ | `subscribe` | Open subscription page |
489
+ | `update` | Update the CLI to the latest version (`npm i -g pixverse@latest`) |
490
+ | `config set` | Set a config value |
491
+ | `config get` | Get a config value |
492
+ | `config list` | List all config values |
493
+ | `config reset` | Reset config to defaults |
494
+ | `config path` | Show config file path |
495
+ | `config defaults` | Manage per-mode creation defaults |
496
496
 
497
497
  ## Global Flags
498
498
 
499
- | Flag | Description |
500
- |:---|:---|
501
- | `--json` | Output as JSON |
502
- | `-p` | Print mode (alias for `--json`) |
499
+ | Flag | Description |
500
+ | :-------------------- | :-------------------------------------------------------- |
501
+ | `--json` | Output as JSON |
502
+ | `-p` | Print mode (alias for `--json`) |
503
503
  | `--workspace-id <id>` | Override active workspace for this command (0 = personal) |
504
- | `-V, --version` | Show CLI version |
505
- | `-h, --help` | Show help for any command |
504
+ | `-V, --version` | Show CLI version |
505
+ | `-h, --help` | Show help for any command |
506
506
 
507
507
  ## For AI Agents — Advanced Usage
508
508
 
@@ -521,6 +521,7 @@ npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-an
521
521
  [https://clawhub.ai/pixverse-official/pixverse-ai-image-and-video-generator](https://clawhub.ai/pixverse-official/pixverse-ai-image-and-video-generator)
522
522
 
523
523
  Skills include:
524
+
524
525
  - Per-model parameter constraints (which models support which modes, quality levels, durations, aspect ratios)
525
526
  - End-to-end workflow pipelines (text-to-video, storyboard-to-video, video production, motion control, etc.)
526
527
  - Prompt optimization techniques for better generation quality
@@ -5,7 +5,7 @@
5
5
  "cli": {
6
6
  "name": "pixverse",
7
7
  "package": "pixverse",
8
- "version": "1.2.0",
8
+ "version": "1.2.2",
9
9
  "binary": "pixverse",
10
10
  "node": ">=20",
11
11
  "description": "PixVerse CLI - generate videos and images from the command line"
@@ -297,12 +297,12 @@
297
297
  },
298
298
  {
299
299
  "cmd": "pixverse create reference",
300
- "desc": "Multi-subject character fusion video",
300
+ "desc": "Multi-subject character reference video",
301
301
  "run": true,
302
302
  "auth": true,
303
303
  "effect": "creates_remote_media_asset",
304
304
  "options": {
305
- "--images <inputs...>": "Image inputs: file paths, HTTPS URLs, image IDs, or media paths (1–7; local oversized images are auto-resized to fit 1920x1920)",
305
+ "--images <inputs...>": "Image inputs: file paths, HTTPS URLs, image IDs, or media paths (1–7, up to 9 for seedance-2.0; local oversized images are auto-resized to fit 1920x1920)",
306
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
307
  "--prompt <text>": "Prompt text",
308
308
  "-m, --model <model>": "Video model",