pixverse 1.3.5 → 1.3.10

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 +20 -10
  2. package/dist/capabilities.json +11 -6
  3. package/dist/index.js +1 -1
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -64,6 +64,8 @@ This opens a browser where you confirm the authorization. You can also copy the
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
+ | FLUX 3 | `flux-3.0` | `720p` `1080p` | `5`–`20`s | `auto` `21:9` `2:1` `16:9` `4:3` `1:1` `3:4` `9:16` |
68
+ | Wan 3.0 | `wan-3.0` | `480p` `720p` `1080p` | `2`–`30`s | `auto` `16:9` `4:3` `1:1` `3:4` `9:16` |
67
69
  | Google Gemini Omni | `gemini-omni-flash` | `720p` | `3`–`10`s | `16:9` `9:16` |
68
70
  | Happy Horse 1.0 | `happyhorse-1.0` | `720p` `1080p` | `3`–`15`s | `16:9` `9:16` `1:1` `4:3` `3:4` |
69
71
  | Kling O3 Pro | `kling-o3-pro` | _not applicable_ | `3`–`15`s | `16:9` `9:16` `1:1` |
@@ -87,6 +89,10 @@ This opens a browser where you confirm the authorization. You can also copy the
87
89
 
88
90
  > 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`.
89
91
 
92
+ > FLUX 3 is available only in `create video`. Text-to-video defaults to `16:9`; image-to-video defaults to `auto` while preserving an explicit fixed ratio. Requests always include the model's fixed safety setting.
93
+
94
+ > Wan 3.0 defaults to `720p`, 5 seconds, and `auto`, and is available in video, two-frame transition, and reference creation. Reference accepts up to 10 images, 5 videos, and 5 audios (20 total), including audio-only input. Video and audio reference durations are each limited to 15 seconds in aggregate. With a video reference, duration defaults to `auto`; fixed output duration is limited by `30 - reference video duration`.
95
+
90
96
  > Kling resolution is selected entirely by the model ID. Kling requests do not send `quality`; an explicit `--quality` value is ignored with a warning. Both 4K models support text/image-to-video and two-frame transitions, while only Kling O3 4K supports `create reference`.
91
97
 
92
98
  > 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; requests with a video lock duration to `auto` and reject fixed values. 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 with normal fixed duration or exactly 1 MP4 video up to 8.7s; video mode locks duration to `auto` and derives aspect ratio from the source video.
@@ -99,10 +105,10 @@ This opens a browser where you confirm the authorization. You can also copy the
99
105
 
100
106
  | Creation mode | Supported `--model` values |
101
107
  | :---------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
102
- | `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-o3-4k` `kling-3.0-pro` `kling-3.0-standard` `kling-3.0-4k` `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` |
108
+ | `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` `flux-3.0` `wan-3.0` `gemini-omni-flash` `happyhorse-1.0` `kling-o3-pro` `kling-o3-standard` `kling-o3-4k` `kling-3.0-pro` `kling-3.0-standard` `kling-3.0-4k` `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` |
103
109
  | `create extend` | `v6` `grok-imagine` |
104
- | `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` `kling-o3-4k` `grok-imagine` `v5.6` |
105
- | `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-o3-4k` `kling-3.0-pro` `kling-3.0-standard` `kling-3.0-4k` `veo-3.1-lite` `veo-3.1-standard` `veo-3.1-fast` `v5.6` |
110
+ | `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` `wan-3.0` `gemini-omni-flash` `kling-o3-pro` `kling-o3-standard` `kling-o3-4k` `grok-imagine` `v5.6` |
111
+ | `create transition` (2 frames) | `v6` `pixverse-c1` `seedance-2.5` `seedance-2.0-standard` `seedance-2.0-fast` `seedance-2.0-mini` `minimax-h3` `wan-3.0` `kling-o3-pro` `kling-o3-standard` `kling-o3-4k` `kling-3.0-pro` `kling-3.0-standard` `kling-3.0-4k` `veo-3.1-lite` `veo-3.1-standard` `veo-3.1-fast` `v5.6` |
106
112
  | `create transition` (3+ frames) | `v5` |
107
113
  | `create modify` | `v5.5` |
108
114
  | `create motion-control` | `v5.6` |
@@ -281,6 +287,9 @@ pixverse create reference -m seedance-2.0-standard --images ./char.png --audios
281
287
  # MiniMax H3 reference — mix up to 9 images, 3 videos, and 3 audios
282
288
  pixverse create reference -m minimax-h3 --images ./char.png --videos ./motion.mp4 --audios ./voice.mp3 --prompt "@image1 follows @video1 and @audio1"
283
289
 
290
+ # Wan 3.0 reference — mixed inputs or audio-only, with automatic output duration when video is present
291
+ pixverse create reference -m wan-3.0 --videos ./motion.mp4 --audios ./voice.mp3 --duration auto --prompt "Follow @video1 and @audio1"
292
+
284
293
  # Motion control — character image + motion reference video
285
294
  pixverse create motion-control --image ./character.png --video ./dance.mp4
286
295
 
@@ -592,13 +601,14 @@ pixverse asset download "$VID" --dest ./output/
592
601
 
593
602
  ## Global Flags
594
603
 
595
- | Flag | Description |
596
- | :-------------------- | :-------------------------------------------------------- |
597
- | `--json` | Output as JSON |
598
- | `-p` | Print mode (alias for `--json`) |
599
- | `--workspace-id <id>` | Override active workspace for this command (0 = personal) |
600
- | `-V, --version` | Show CLI version |
601
- | `-h, --help` | Show help for any command |
604
+ | Flag | Description |
605
+ | :-------------------- | :---------------------------------------------------------- |
606
+ | `--json` | Output as JSON |
607
+ | `-p` | Print mode (alias for `--json`) |
608
+ | `--workspace-id <id>` | Override active workspace for this command (0 = personal) |
609
+ | `--region <region>` | Service region: `global` or `cn` (default: `global`) |
610
+ | `-V, --version` | Show CLI version |
611
+ | `-h, --help` | Show help for any command |
602
612
 
603
613
  ## For AI Agents — Advanced Usage
604
614
 
package/dist/capabilities.json CHANGED
@@ -5,13 +5,16 @@
5
5
  "cli": {
6
6
  "name": "pixverse",
7
7
  "package": "pixverse",
8
- "version": "1.3.5",
8
+ "version": "1.3.10",
9
9
  "binary": "pixverse",
10
10
  "node": ">=22.12.0",
11
11
  "description": "PixVerse CLI - generate videos and images from the command line"
12
12
  },
13
13
  "contract": {
14
14
  "service": "PixVerse public service",
15
+ "regions": ["global", "cn"],
16
+ "default_region": "global",
17
+ "region_precedence": ["PIXVERSE_REGION", "--region", "default"],
15
18
  "auth": "OAuth device flow with a local CLI session",
16
19
  "json": "Use --json or -p for pure JSON stdout; errors and progress go to stderr.",
17
20
  "text_inputs": "prompt, text, lyrics accept literal text, local file path, or - for stdin.",
@@ -32,7 +35,8 @@
32
35
  "--json": "Output results as JSON",
33
36
  "-p": "Print mode - pure JSON output (alias for --json)",
34
37
  "--workspace-id <id>": "Override active workspace for this command (0 = personal)",
35
- "--trace-id <id>": "Trace ID to attach to all API requests in this invocation (must be UUIDv4)"
38
+ "--trace-id <id>": "Trace ID to attach to all API requests in this invocation (must be UUIDv4)",
39
+ "--region <region>": "Region: global or cn (default: global; PIXVERSE_REGION overrides) | choices: global, cn"
36
40
  },
37
41
  "commands": [
38
42
  {
@@ -59,7 +63,8 @@
59
63
  "--json": "Output results as JSON",
60
64
  "-p": "Print mode - pure JSON output (alias for --json)",
61
65
  "--workspace-id <id>": "Override active workspace for this command (0 = personal)",
62
- "--trace-id <id>": "Trace ID to attach to all API requests in this invocation (must be UUIDv4)"
66
+ "--trace-id <id>": "Trace ID to attach to all API requests in this invocation (must be UUIDv4)",
67
+ "--region <region>": "Region: global or cn (default: global; PIXVERSE_REGION overrides) | choices: global, cn"
63
68
  }
64
69
  },
65
70
  {
@@ -301,14 +306,14 @@
301
306
  "effect": "creates_remote_media_asset",
302
307
  "options": {
303
308
  "--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
- "--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)",
309
+ "--videos <inputs...>": "Video references: file paths, HTTPS URLs, video IDs, or media paths (supported by V6, Seedance, MiniMax H3, Wan 3.0, Gemini Omni, Kling O3, and Grok Imagine; model-specific limits apply)",
310
+ "--audios <inputs...>": "Audio references (Seedance, MiniMax H3, and Wan 3.0): file paths, HTTPS URLs, audio IDs, or media paths (model-specific count and known-duration limits apply; Wan 3.0 permits audio-only input)",
306
311
  "--prompt <text>": "Prompt text",
307
312
  "-m, --model <model>": "Video model",
308
313
  "--task-type <type>": "Seedance 2.5 reference task type: auto, reference, edit, or extend",
309
314
  "-q, --quality <quality>": "Video quality",
310
315
  "--aspect-ratio <ratio>": "Aspect ratio, or auto for model-determined framing where supported",
311
- "-d, --duration <seconds|auto>": "Duration in seconds, or auto (locked for V6/Grok video references; default for Seedance 2.5 video references)",
316
+ "-d, --duration <seconds|auto>": "Duration in seconds, or auto (locked for V6/Grok video references; default for Seedance 2.5/Wan 3.0 video references)",
312
317
  "--count <number>": "Number of generations",
313
318
  "--seed <number>": "Random seed",
314
319
  "--audio": "Enable audio generation",