pixverse 1.2.13 → 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 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 | `minimax-h3` | `768p` `1440p` | `5`–`15`s | `auto` `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` |
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 | Quality | Aspect Ratio |
106
- | :---------------------- | :------------------ | :----------------------------- | :------------------------------------------------------------- |
107
- | 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` |
108
- | Nano Banana 2 | `gemini-3.1-flash` | `512p` `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
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` | `720p` `1080p` | `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` |
111
- | Nano Banana Pro | `gemini-3.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
112
- | Nano Banana | `gemini-2.5-flash` | `1080p` | `auto` `1:1` `16:9` `9:16` + more |
113
- | Seedream 5.0 Pro | `seedream-5.0-pro` | `1080p` `1440p` | `auto` `1:1` `16:9` `9:16` + more |
114
- | Seedream 5.0 Lite | `seedream-5.0-lite` | `1440p` `1800p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
115
- | Seedream 4.5 | `seedream-4.5` | `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
116
- | Seedream 4.0 | `seedream-4.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` + more |
117
- | Kling Image O3 | `kling-image-o3` | `1080p` `1440p` `2160p` | `16:9` `9:16` `1:1` + more |
118
- | Kling Image V3 | `kling-image-v3` | `1080p` `1440p` | `16:9` `9:16` `1:1` + more |
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,41 @@ 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
+
290
+ ### MiniApps
291
+
292
+ MiniApps are preset, single-purpose generators from the PixVerse web app (Magic
293
+ Extend, Image Region Editor, …). The CLI is a thin pass-through: it does not
294
+ bundle each app's parameter schema. Instead, `miniapps info <id>` returns the
295
+ app's **parameter schema** (required fields, types, enum values, and a
296
+ copy-pasteable example) — read it, then submit the app id plus its `args` as JSON
297
+ with `miniapps create`.
298
+
299
+ ```bash
300
+ # List available MiniApps
301
+ pixverse miniapps list
302
+
303
+ # Show a MiniApp's details + its parameter schema (what to put in --params)
304
+ pixverse miniapps info magic_extend # add --json for the machine-readable params_schema
305
+
306
+ # Create a MiniApp project — --id and --params are required; --params takes JSON (a literal, a file path, or - for stdin)
307
+ pixverse miniapps create --id magic_extend --params '{"image":"<media-path>","ratio":"16:9","quality":"720p"}'
308
+ pixverse miniapps create --id image_region_editor --params ./args.json
309
+
310
+ # create returns a project_id — query / download / delete it with --type miniapps
311
+ pixverse task status <project_id> --type miniapps
312
+ pixverse task wait <project_id> --type miniapps
313
+ pixverse asset info <project_id> --type miniapps
314
+ pixverse asset download <project_id> --type miniapps --dest ./out/
315
+ pixverse asset delete <project_id> --type miniapps
316
+ ```
317
+
318
+ Media fields inside `--params` must be **media paths** — the `path` returned by
319
+ `asset upload` (not a URL, not a local file). The CLI passes `--params` straight
320
+ through without uploading, so upload first with `pixverse asset upload <file>` and
321
+ use the returned `path`.
322
+
272
323
  ### Task Management
273
324
 
274
325
  ```bash
@@ -278,6 +329,9 @@ pixverse task status <id>
278
329
  # Poll a voice/music audio task (audio is not auto-detected — pass --type audio)
279
330
  pixverse task status <id> --type audio
280
331
 
332
+ # Poll a MiniApp project (pass --type miniapps; project_id comes from `miniapps create`)
333
+ pixverse task status <project_id> --type miniapps
334
+
281
335
  # Batch status query with space-separated IDs (parallel; per-ID failures captured)
282
336
  pixverse task status 123 456 789 --type video --json
283
337
 
@@ -296,6 +350,7 @@ pixverse asset list
296
350
  pixverse asset list --type image
297
351
  pixverse asset list --type audio # voice and music audio history
298
352
  pixverse asset list --type audio --source upload
353
+ pixverse asset list --type miniapps # MiniApp projects
299
354
  pixverse asset list --source upload
300
355
  pixverse asset list --source create --off-peak
301
356
 
@@ -445,16 +500,16 @@ pixverse asset download "$VID" --dest ./output/
445
500
 
446
501
  ### Exit Codes
447
502
 
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 |
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 |
458
513
 
459
514
  ## All Commands
460
515
 
@@ -481,7 +536,7 @@ pixverse asset download "$VID" --dest ./output/
481
536
  | `voice models` | List voice/TTS providers, models, and supported languages |
482
537
  | `voice presets` | List preset voices (filterable by model / language / provider) |
483
538
  | `music models` | List music providers, models, and capabilities |
484
- | `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,...` |
485
540
  | `task wait` | Wait for task completion |
486
541
  | `asset list` | List assets (`--source create\|upload`, `--type video\|image\|audio`, `--off-peak`) |
487
542
  | `asset upload` | Upload a local file or HTTPS URL to asset library |
@@ -5,7 +5,7 @@
5
5
  "cli": {
6
6
  "name": "pixverse",
7
7
  "package": "pixverse",
8
- "version": "1.2.13",
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"
@@ -49,6 +49,7 @@
49
49
  "template",
50
50
  "voice",
51
51
  "music",
52
+ "miniapps",
52
53
  "saved",
53
54
  "workspace",
54
55
  "update"
@@ -299,9 +300,9 @@
299
300
  "auth": true,
300
301
  "effect": "creates_remote_media_asset",
301
302
  "options": {
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 duration15s)",
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)",
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)",
305
306
  "--prompt <text>": "Prompt text",
306
307
  "-m, --model <model>": "Video model",
307
308
  "-q, --quality <quality>": "Video quality",
@@ -375,7 +376,7 @@
375
376
  },
376
377
  "options": {
377
378
  "--ids <ids>": "Comma-separated list of IDs for batch query (e.g. 123,456,789)",
378
- "--type <type>": "Asset type: video, image, or audio | default: video",
379
+ "--type <type>": "Asset type: video, image, audio, or miniapps | default: video",
379
380
  "--json": "Output as JSON"
380
381
  }
381
382
  },
@@ -385,10 +386,10 @@
385
386
  "run": true,
386
387
  "auth": true,
387
388
  "args": {
388
- "id": "Video, image, or audio ID"
389
+ "id": "Video, image, audio, or MiniApp project ID"
389
390
  },
390
391
  "options": {
391
- "--type <type>": "Asset type: video, image, or audio | default: video",
392
+ "--type <type>": "Asset type: video, image, audio, or miniapps | default: video",
392
393
  "--timeout <seconds>": "Timeout in seconds | default: 300",
393
394
  "--json": "Output as JSON"
394
395
  }
@@ -404,7 +405,7 @@
404
405
  "run": true,
405
406
  "auth": true,
406
407
  "options": {
407
- "--type <type>": "Asset type: video, image, or audio | default: video | choices: video, image, audio",
408
+ "--type <type>": "Asset type: video, image, audio, or miniapps | default: video | choices: video, image, audio, miniapps",
408
409
  "--source <source>": "Asset source: create or upload | default: create | choices: create, upload",
409
410
  "--off-peak": "Filter off-peak generations only (video + create only)",
410
411
  "--limit <number>": "Number of items per page | default: 20",
@@ -421,7 +422,7 @@
421
422
  "id": "Video, image, or audio ID"
422
423
  },
423
424
  "options": {
424
- "--type <type>": "Asset type: video, image, or audio (auto-detected if omitted)",
425
+ "--type <type>": "Asset type: video, image, audio, or miniapps (auto-detected if omitted; miniapps must be explicit)",
425
426
  "--source <source>": "Audio source: create or upload | default: create | choices: create, upload",
426
427
  "--json": "Output as JSON"
427
428
  }
@@ -435,7 +436,7 @@
435
436
  "id": "Created video, image, or audio ID (uploads not downloadable)"
436
437
  },
437
438
  "options": {
438
- "--type <type>": "Asset type: video, image, or audio (auto-detected if omitted)",
439
+ "--type <type>": "Asset type: video, image, audio, or miniapps (auto-detected if omitted; miniapps must be explicit)",
439
440
  "--dest <path>": "Destination directory",
440
441
  "--json": "Output as JSON"
441
442
  }
@@ -464,7 +465,7 @@
464
465
  "id": "Video, image, or audio ID"
465
466
  },
466
467
  "options": {
467
- "--type <type>": "Asset type: video, image, or audio (auto-detected if omitted) | choices: video, image, audio",
468
+ "--type <type>": "Asset type: video, image, audio, or miniapps (auto-detected if omitted; miniapps must be explicit) | choices: video, image, audio, miniapps",
468
469
  "--source <source>": "Asset source: create or upload | default: create | choices: create, upload",
469
470
  "--json": "Output as JSON"
470
471
  }
@@ -702,6 +703,46 @@
702
703
  "--json": "Output as JSON"
703
704
  }
704
705
  },
706
+ {
707
+ "cmd": "pixverse miniapps",
708
+ "desc": "Run PixVerse MiniApps (preset generators)",
709
+ "children": ["list", "info", "create"]
710
+ },
711
+ {
712
+ "cmd": "pixverse miniapps list",
713
+ "desc": "List available MiniApps",
714
+ "run": true,
715
+ "auth": true,
716
+ "options": {
717
+ "--json": "Output as JSON"
718
+ }
719
+ },
720
+ {
721
+ "cmd": "pixverse miniapps info",
722
+ "desc": "Show a MiniApp's details",
723
+ "run": true,
724
+ "auth": true,
725
+ "args": {
726
+ "id": "MiniApp id (e.g. magic_extend)"
727
+ },
728
+ "options": {
729
+ "--json": "Output as JSON"
730
+ }
731
+ },
732
+ {
733
+ "cmd": "pixverse miniapps create",
734
+ "desc": "Create a MiniApp project (returns a project_id)",
735
+ "run": true,
736
+ "auth": true,
737
+ "options": {
738
+ "--id <app_id>": "MiniApp id, e.g. magic_extend or image_region_editor",
739
+ "--params <input>": "App args as JSON (required) - a literal string, a file path, or - for stdin",
740
+ "--output <path>": "Download the finished main asset to this directory",
741
+ "--no-wait": "Return immediately with the project_id, without polling | negates: wait",
742
+ "--timeout <seconds>": "Polling timeout in seconds | default: 300",
743
+ "--json": "Output as JSON"
744
+ }
745
+ },
705
746
  {
706
747
  "cmd": "pixverse saved",
707
748
  "desc": "Manage saved folders and their contents",