pixverse 1.4.19 → 1.4.21

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
@@ -61,7 +61,8 @@ Supported modes are `pixverse create` subcommands. Defaults are mode-specific.
61
61
  | :--- | :--- | :--- | :--- | :--- | :--- |
62
62
  | PixVerse V6 | `v6` | `video` (default), `transition` (2 frames, default), `extend` (default), `reference` (default) | `360p` `540p` `720p` `1080p` | `1`–`15`s | `16:9` `21:9` `4:3` `1:1` `3:4` `9:16` `3:2` `2:3` |
63
63
  | PixVerse C1 | `pixverse-c1` | `video`, `transition` (2 frames), `reference` | `360p` `540p` `720p` `1080p` | `1`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `3:2` `2:3` |
64
- | Seedance 2.5 | `seedance-2.5` | `video`, `transition` (2 frames), `reference` | `480p` `720p` `1080p` | `4`–`30`s | `auto` `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` |
64
+ | Seedance 2.5 | `seedance-2.5` | `video`, `transition` (2 frames), `reference` | `480p` `720p` `1080p` `2160p` | `4`–`30`s | `auto` `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` |
65
+ | Seedance 2.5 Flash | `seedance-2.5-flash` | `video`, `transition` (2 frames), `reference` | `720p` `480p` | `4`–`30`s | `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` `auto` |
65
66
  | Seedance 2.5 Draft | `seedance-2.5-480draft` | `video`, `transition` (2 frames), `reference` | `480p` | `4`–`30`s | `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` `auto` |
66
67
  | Seedance 2.0 Standard | `seedance-2.0-standard` | `video`, `transition` (2 frames), `reference` | `480p` `720p` `1080p` `2160p` | `4`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` |
67
68
  | Seedance 2.0 Fast | `seedance-2.0-fast` | `video`, `transition` (2 frames), `reference` | `480p` `720p` | `4`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` |
@@ -112,24 +113,25 @@ Supported modes are `pixverse create` subcommands. Defaults are mode-specific.
112
113
 
113
114
  Image `--quality` accepts case-insensitive aliases: `1K` → `1080p`, `2K` → `1440p`, `3K` → `1800p`, `4K` → `2160p`, and `1.5K` → `1.5k`. The selected model must support the corresponding quality.
114
115
 
115
- | Model | `--model` value | Quality | Aspect Ratio | Max references | Background (`--background`) |
116
- | :--- | :--- | :--- | :--- | :--- | :--- |
117
- | GPT Image 2.5 Flare _(default)_ | `gpt-image-2.5-flare` | `1080p` `1440p` `2160p` | `1:1` `16:9` `9:16` `4:3` `3:4` `3:2` `2:3` `2:1` `1:2` `21:9` | 16 | `auto` `transparent` `opaque` |
118
- | GPT Image 2.5 Sunburst | `gpt-image-2.5-sunburst` | `1080p` `1440p` `2160p` | `1:1` `16:9` `9:16` `4:3` `3:4` `3:2` `2:3` `2:1` `1:2` `21:9` | 16 | `auto` `transparent` `opaque` |
119
- | GPT Image 2 | `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` | 9 | — |
120
- | Nano Banana 2.1 | `gemini-nano-banana-2.1` | `1080p` `1440p` `2160p` | `auto` `1:1` `3:2` `2:3` `3:4` `4:3` `4:5` `5:4` `9:16` `16:9` `21:9` `1:4` `4:1` `1:8` `8:1` | 14 | — |
121
- | Nano Banana 2 | `gemini-3.1-flash` | `512p` `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 9 | — |
122
- | Nano Banana 2 Lite | `gemini-3.1-flash-lite` | `1080p` | `auto` `1:1` `3:2` `2:3` `3:4` `4:3` `4:5` `5:4` `9:16` `16:9` `21:9` | 14 | — |
123
- | 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` | 3 | — |
124
- | Nano Banana Pro | `gemini-3.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 9 | — |
125
- | Nano Banana | `gemini-2.5-flash` | `1080p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 3 | — |
126
- | Seedream 5.5 | `seedream-5.5` | `1080p` `1.5k` `1440p` `1800p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 10 | `auto` `transparent` `opaque` |
127
- | Seedream 5.0 Pro | `seedream-5.0-pro` | `1080p` `1440p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 10 | — |
128
- | Seedream 5.0 Lite | `seedream-5.0-lite` | `1440p` `1800p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 6 | — |
129
- | Seedream 4.5 | `seedream-4.5` | `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 6 | — |
130
- | Seedream 4.0 | `seedream-4.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 6 | — |
131
- | Kling Image O3 | `kling-image-o3` | `1080p` `1440p` `2160p` | `16:9` `9:16` `1:1` `4:3` `3:4` `3:2` `2:3` `21:9` | 10 | — |
132
- | Kling Image V3 | `kling-image-v3` | `1080p` `1440p` | `16:9` `9:16` `1:1` `4:3` `3:4` `3:2` `2:3` `21:9` | 1 | — |
116
+ | Model | `--model` value | Quality | Aspect Ratio | Max references | Background (`--background`) | Output format (`--output-format`) |
117
+ | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
118
+ | GPT Image 2.5 Flare _(default)_ | `gpt-image-2.5-flare` | `1080p` `1440p` `2160p` | `1:1` `16:9` `9:16` `4:3` `3:4` `3:2` `2:3` `2:1` `1:2` `21:9` | 16 | `auto` `transparent` `opaque` | — |
119
+ | GPT Image 2.5 Sunburst | `gpt-image-2.5-sunburst` | `1080p` `1440p` `2160p` | `1:1` `16:9` `9:16` `4:3` `3:4` `3:2` `2:3` `2:1` `1:2` `21:9` | 16 | `auto` `transparent` `opaque` | — |
120
+ | GPT Image 2 | `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` | 9 | — | — |
121
+ | Nano Banana 2.1 | `gemini-nano-banana-2.1` | `1080p` `1440p` `2160p` | `auto` `1:1` `3:2` `2:3` `3:4` `4:3` `4:5` `5:4` `9:16` `16:9` `21:9` `1:4` `4:1` `1:8` `8:1` | 14 | — | — |
122
+ | Nano Banana 2 | `gemini-3.1-flash` | `512p` `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 9 | — | — |
123
+ | Nano Banana 2 Lite | `gemini-3.1-flash-lite` | `1080p` | `auto` `1:1` `3:2` `2:3` `3:4` `4:3` `4:5` `5:4` `9:16` `16:9` `21:9` | 14 | — | — |
124
+ | 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` | 3 | — | — |
125
+ | MiniMax H3 Image | `minimax-h3-image` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 16 | — | `png` `jpeg` `webp` |
126
+ | Nano Banana Pro | `gemini-3.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 9 | — | — |
127
+ | Nano Banana | `gemini-2.5-flash` | `1080p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 3 | — | — |
128
+ | Seedream 5.5 | `seedream-5.5` | `1080p` `1.5k` `1440p` `1800p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 10 | `auto` `transparent` `opaque` | — |
129
+ | Seedream 5.0 Pro | `seedream-5.0-pro` | `1080p` `1440p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 10 | — | — |
130
+ | Seedream 5.0 Lite | `seedream-5.0-lite` | `1440p` `1800p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 6 | — | — |
131
+ | Seedream 4.5 | `seedream-4.5` | `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 6 | — | — |
132
+ | Seedream 4.0 | `seedream-4.0` | `1080p` `1440p` `2160p` | `auto` `1:1` `16:9` `9:16` `4:3` `3:4` `5:4` `4:5` `3:2` `2:3` `21:9` | 6 | — | — |
133
+ | Kling Image O3 | `kling-image-o3` | `1080p` `1440p` `2160p` | `16:9` `9:16` `1:1` `4:3` `3:4` `3:2` `2:3` `21:9` | 10 | — | — |
134
+ | Kling Image V3 | `kling-image-v3` | `1080p` `1440p` | `16:9` `9:16` `1:1` `4:3` `3:4` `3:2` `2:3` `21:9` | 1 | — | — |
133
135
 
134
136
  ### Voice / TTS Models (`create voice --model <value>`)
135
137
 
@@ -307,20 +309,20 @@ pixverse create template --template-id 12345 --image ./photo.png
307
309
  ```
308
310
 
309
311
  Seedance 2.5 Draft produces a 480p sample using the independent
310
- `seedance-2.5-480draft` model. After reviewing the sample, create a 1080p Final
311
- from its video ID:
312
+ `seedance-2.5-480draft` model. After reviewing the sample, create a Final from its video ID. The default is 1080p. For 4K, pass
313
+ `--quality 2160p` as shown below.
312
314
 
313
315
  ```bash
314
316
  pixverse create video --model seedance-2.5-480draft --prompt "A bird takes flight" --json
315
317
  pixverse task status <draft_video_id> --json
316
- pixverse create seedance-final --video-id <draft_video_id> --no-wait --json
318
+ pixverse create seedance-final --video-id <draft_video_id> --quality 2160p --no-wait --json
317
319
  pixverse task wait <final_video_id> --json
318
320
  ```
319
321
 
320
322
  Draft also supports `create reference` and two-image `create transition`.
321
323
  Task JSON includes `seedance_draft` with stage, expiry, permission,
322
324
  and related video IDs. The CLI submits the Draft ID directly. The Final creation
323
- service checks eligibility and expiry at submission and inherits the Draft generation parameters. Each accepted Final submission creates a new
325
+ service checks eligibility and expiry at submission and inherits the other generation parameters. Each accepted Final submission creates a new
324
326
  paid task; the CLI never automatically retries it. After a timeout, query the
325
327
  task instead of submitting again. Ordinary `seedance-2.5 --quality 480p` does not
326
328
  create a Draft.
@@ -783,7 +785,7 @@ pixverse asset download "$VID" --dest ./output/
783
785
  | `create music` | Generate music audio from a prompt |
784
786
  | `create extend` | Extend video duration |
785
787
  | `create modify` | Modify an existing video |
786
- | `create seedance-final` | Create a 1080p Final from an eligible Seedance Draft |
788
+ | `create seedance-final` | Create a 1080p or 4K Final from an eligible Seedance Draft |
787
789
  | `create upscale` | Upscale video resolution |
788
790
  | `create reference` | Create or edit a video with reference media |
789
791
  | `create motion-control` | Motion control with character image + reference video |