pixverse-ai-cli 1.4.3 → 1.4.5

package/README.md

@@ -66,6 +66,7 @@ Supported modes are `pixverse create` subcommands. Defaults are mode-specific.
 | 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` |
 | Seedance 2.0 Mini | `seedance-2.0-mini` | `video`, `transition` (2 frames), `reference` | `480p` `720p` | `4`–`15`s | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` |
 | MiniMax H3 | `minimax-h3` | `video`, `transition` (2 frames), `reference` | `768p` `1440p` | `5`–`15`s | `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` `auto` |
+| MiniMax H3 Max | `minimax-h3-max` | `video`, `transition` (2 frames), `reference` | `480p` `768p` `1080p` | `5`–`15`s | `21:9` `16:9` `4:3` `1:1` `3:4` `9:16` `auto` |
 | FLUX 3 | `flux-3.0` | `video` | `720p` `1080p` | `5`–`20`s | `auto` `21:9` `2:1` `16:9` `4:3` `1:1` `3:4` `9:16` |
 | Wan 3.0 | `wan-3.0` | `video`, `transition` (2 frames), `reference` | `480p` `720p` `1080p` | `2`–`30`s | `auto` `16:9` `4:3` `1:1` `3:4` `9:16` |
 | Google Gemini Omni | `gemini-omni-flash` | `video`, `reference` | `720p` | `3`–`10`s | `16:9` `9:16` |
@@ -91,6 +92,8 @@ Supported modes are `pixverse create` subcommands. Defaults are mode-specific.
 
 > 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`.
 
+> MiniMax H3 Max defaults to `768p` and 5 seconds. Text-to-video defaults to `16:9`; image-to-video forces `auto`; reference mode supports both `auto` and fixed aspect ratios, defaults to `auto`, and accepts up to 12 total inputs (9 images, 3 videos, and 3 audios).
+
 > 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.
 
 > 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`.
@@ -277,6 +280,9 @@ pixverse create reference -m seedance-2.0-standard --images ./char.png --audios
 # MiniMax H3 reference — mix up to 9 images, 3 videos, and 3 audios
 pixverse create reference -m minimax-h3 --images ./char.png --videos ./motion.mp4 --audios ./voice.mp3 --prompt "@image1 follows @video1 and @audio1"
 
+# MiniMax H3 Max reference — the same per-type limits, with 12 inputs maximum in total
+pixverse create reference -m minimax-h3-max --images ./char.png --videos ./motion.mp4 --audios ./voice.mp3 --prompt "@image1 follows @video1 and @audio1"
+
 # Wan 3.0 reference — mixed inputs or audio-only, with automatic output duration when video is present
 pixverse create reference -m wan-3.0 --videos ./motion.mp4 --audios ./voice.mp3 --duration auto --prompt "Follow @video1 and @audio1"
 
@@ -376,6 +382,22 @@ pixverse canvas project create \
   --json
 ```
 
+Pass the project ID after the command:
+
+```bash
+pixverse canvas graph get 123456789 --json
+pixverse canvas node get 123456789 --node-id image_01 --json
+```
+
+To automatically arrange and save the entire project's layout:
+
+```bash
+pixverse canvas arrange "$PROJECT_ID" --json
+pixverse canvas graph get "$PROJECT_ID" --json
+```
+
+Read the graph after arranging to get the updated positions and `edit_version`.
+
 For reliable automation, inspect capabilities → read the project → validate the
 patch → apply the patch → dispatch generated nodes → check node status:
 
@@ -392,22 +414,20 @@ pixverse capabilities canvas \
 pixverse canvas node schema --node-type image_generate --json
 
 # 3. Read the project and retain edit_version
-pixverse canvas graph get --project-id "$PROJECT_ID" --json
+pixverse canvas graph get "$PROJECT_ID" --json
 
 # 4. Validate and apply the same patch input
-pixverse canvas patch dry-run --project-id "$PROJECT_ID" --patch patch.json --json
-pixverse canvas patch apply --project-id "$PROJECT_ID" --patch patch.json --json
+pixverse canvas patch dry-run "$PROJECT_ID" --patch patch.json --json
+pixverse canvas patch apply "$PROJECT_ID" --patch patch.json --json
 
 # 5. Start generation only for diff.executable_node_ids from patch apply
-pixverse canvas dispatch \
-  --project-id "$PROJECT_ID" \
+pixverse canvas dispatch "$PROJECT_ID" \
   --node-ids image_01,video_01 \
   --edit-version 13 \
   --json
 
 # 6. Check only the nodes involved in this workflow
-pixverse canvas graph status \
-  --project-id "$PROJECT_ID" \
+pixverse canvas graph status "$PROJECT_ID" \
   --node-ids image_01,video_01 \
   --json
 ```
@@ -431,10 +451,8 @@ contains a `graph_patch` object without an outer request wrapper. For example,
 }
 ```
 
-The `--project-id` flag identifies the project. A matching `project_id` inside
-the patch is accepted for compatibility, but omitting it is preferred. Keep all
-IDs as strings. If the edit version has changed, read the project again and
-rebuild the patch instead of replacing only `base_edit_version`.
+Keep all IDs as strings. If the edit version has changed, read the
+project again and rebuild the patch instead of replacing only `base_edit_version`.
 
 For the same project and unchanged patch file, `dry-run` and `apply`
 automatically derive the same stable idempotency key. Use
@@ -444,39 +462,32 @@ Additional Canvas operations:
 
 ```bash
 # Bind a specific batch of ready nodes to a dispatch plan
-pixverse canvas dispatch rebind \
-  --project-id "$PROJECT_ID" \
+pixverse canvas dispatch rebind "$PROJECT_ID" \
   --dispatch-plan-id plan-20260817-001 \
   --node-ids image_01,video_01 \
   --json
 
 # After confirmation, dispatch the same nodes with rebind's edit_version
-pixverse canvas dispatch \
-  --project-id "$PROJECT_ID" \
+pixverse canvas dispatch "$PROJECT_ID" \
   --dispatch-plan-id plan-20260817-001 \
   --node-ids image_01,video_01 \
   --edit-version "$REBIND_EDIT_VERSION" \
   --json
 
 # List, inspect, and apply saved node versions
-pixverse canvas node versions \
-  --project-id "$PROJECT_ID" --node-id video_01 \
+pixverse canvas node versions "$PROJECT_ID" --node-id video_01 \
   --page 1 --page-size 20 --json
-pixverse canvas node version \
-  --project-id "$PROJECT_ID" --node-id video_01 \
+pixverse canvas node version "$PROJECT_ID" --node-id video_01 \
   --history-id "$HISTORY_ID" --json
-pixverse canvas node version apply \
-  --project-id "$PROJECT_ID" --node-id video_01 \
+pixverse canvas node version apply "$PROJECT_ID" --node-id video_01 \
   --history-id "$HISTORY_ID" --json
 
 # Run generation again for a specific failed node
-pixverse canvas node rerun \
-  --project-id "$PROJECT_ID" --node-id video_01 \
+pixverse canvas node rerun "$PROJECT_ID" --node-id video_01 \
   --edit-version 13 --json
 
 # Extract the full audio track from a video node
-pixverse canvas node extract-audio \
-  --project-id "$PROJECT_ID" \
+pixverse canvas node extract-audio "$PROJECT_ID" \
   --node-id audio_extract_01 \
   --source-node-id video_01 \
   --json
@@ -755,6 +766,7 @@ pixverse asset download "$VID" --dest ./output/
 | `config path`                | Show config file path                                                               |
 | `config defaults`            | Manage per-mode creation defaults                                                   |
 | `canvas project create`      | Create an empty Canvas project with an optional name and description                |
+| `canvas arrange`             | Automatically arrange and save all nodes in a Canvas project                        |
 | `canvas graph get`           | Get a Canvas project's nodes, connections, and edit version                         |
 | `canvas graph status`        | Get the generation status of Canvas nodes                                           |
 | `canvas graph invalid-nodes` | Show Canvas validation issues and invalid node details                              |