Skip to content

[Frontend] Add MiniMax H3 video upscale workflow (WF-07) - #7472

Merged
princepride merged 5 commits into
vllm-project:mainfrom
xuexueligao:codex/wf07-h3-upscale-pr-20260913
Sep 15, 2026
Merged

princepride merged 5 commits into
vllm-project:mainfrom
xuexueligao:codex/wf07-h3-upscale-pr-20260913

Conversation

@xuexueligao

@xuexueligao xuexueligao commented Sep 13, 2026 •

Copy link
Copy Markdown
Contributor

Purpose

Adds WF-07 from #7380: generate H3 video and audio through vLLM-Omni, upscale the frames with SeedVR2 3B FP16, and save both videos with the generated audio and FPS.

The PR adds UI/API workflow templates and setup notes using existing nodes. No node implementation or test files are added.

Test Plan

  1. Install the SeedVR2 ComfyUI plugin and its DiT/VAE weights, and configure the H3 service as described in the workflow setup.
  2. Import the UI workflow, set the service URL/model and server-side LoRA path, and run it. An API workflow is also included.
  3. Compare the two saved MP4s and check their frame count, FPS, duration and audio.

Test Result

Executed the complete workflow against live H3 and ComfyUI services on 2026-09-15. The H3 generation node used a fresh seed. Download the exact workflow used for this run.

Original SeedVR2 output
Resolution 1344 x 768 2688 x 1536
Frames / FPS 124 / 24 124 / 24
Video duration 5.166667 s 5.166667 s
Audio AAC, 32 kHz stereo AAC, 32 kHz stereo

Original video · Upscaled video with audio · Side-by-side comparison

The comparison shows a full-frame overview followed by matching central crops. The original crop is enlarged 2x with bicubic interpolation for display; the SeedVR2 crop uses native pixels.

Measured audio lag before/after upscale: 0 ms. Media measurements and run records. These measurements check timing and audio preservation.

ComfyUI workflow

SeedVR2 output in ComfyUI

Formatting and Markdown checks passed.

AI assistance: Codex assisted with the workflow, documentation and validation.

This is my first contribution to vLLM-Omni. Please let me know if any changes are needed, and I'll update the PR.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 13, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-13T09:06:14.714275Z bb9ff78 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@vllm-omni-review-bot

Copy link
Copy Markdown

This PR appears to be related to model: MinimaxH3.

Model owners: @david6666666 @alex-jw-brooks @fhfuih

Routing: @david6666666 via semantic router, model owner; @alex-jw-brooks via CODEOWNERS; @fhfuih via CODEOWNERS

@xuexueligao, please review your own changes and leave a short self-review comment describing what you checked. PRs without author self-review may not be assigned a reviewer.

Please take a look when you have a chance. If you would like an automated review, mention @vllm-omni-review-bot in a comment.

@vllm-omni-review-bot

vllm-omni-review-bot commented Sep 13, 2026 •

Copy link
Copy Markdown

Omni ReviewBot triage note

Resolved as of aa929967cc86: the high-priority or low-quality signal noted on an earlier commit no longer applies.

@xuexueligao

xuexueligao commented Sep 14, 2026 •

Copy link
Copy Markdown
Contributor Author

Self-review updated for cacafda. Codex performed the following checks during PR preparation.

  • Reviewed the four-file PR diff: README, concise setup notes and UI/API workflows. The previously added E2E case and validation script are removed; existing project tests are unchanged.
  • Loaded the SeedVR2 workflow in ComfyUI and ran H3 generation, frame upscaling and video saving against the real services. Both saved videos have 124 frames at 24 FPS, with AAC 32 kHz stereo audio. Resolution changes from 1344 x 768 to 2688 x 1536; measured audio lag is 0 ms.
  • Checked workflow connections, file endings, line endings, whitespace, spelling and Markdown. The description links the new SeedVR2 workflow, screenshots and comparison videos. Run records.

@hsliuustc0106 hsliuustc0106 added frontend code related to entrypoint diffusion codes related to diffusion models enhancement New feature or request labels Sep 14, 2026
@princepride

Copy link
Copy Markdown
Collaborator

@xuexueligao can you also share the result after upscale the original video?

@xuexueligao

Copy link
Copy Markdown
Contributor Author

@xuexueligao can you also share the result after upscale the original video?

ok

@princepride

Copy link
Copy Markdown
Collaborator

pls refer to this pr: #7456

@xuexueligao

xuexueligao commented Sep 14, 2026 •

Copy link
Copy Markdown
Contributor Author

Added the upscaled video with audio (2688 x 1536) and the original video (1344 x 768) to the PR description for comparison, along with the ComfyUI workflow screenshot and workflow JSON.

Also synced with main after #7456 merged: the workflow now uses its duration input and existing audio/aspect-ratio handling. The duplicate production changes are removed. The test changes contain one live E2E case only, and its rerun passed (1 passed, 14 warnings). The description and self-review link the final run's configuration and raw results.

Add remote H3 generation with frame upscaling and preservation of the
returned audio and FPS. Include UI/API workflows, aspect-ratio forwarding,
validation commands and CPU regression coverage.

The bytes_to_video audio fix is taken from YichenLiu (@amchen2310),
PR vllm-project#6782, commit f1ab717.
Its original implementation is retained with the project-required SPDX header.

Refs: vllm-project#7380
Signed-off-by: xuezhihao <89690814+xuexueligao@users.noreply.github.com>
Replace the four CPU regression cases with one E2E case that submits the workflow to running ComfyUI and H3 services and verifies both MP4 outputs.

Record the UI workflow and seed with the request, reject cached generation, and document service prerequisites.

Signed-off-by: xuezhihao <89690814+xuexueligao@users.noreply.github.com>
Signed-off-by: xuezhihao <89690814+xuexueligao@users.noreply.github.com>
@xuexueligao
xuexueligao force-pushed the codex/wf07-h3-upscale-pr-20260913 branch from 9724dba to 684a4e0 Compare September 14, 2026 04:12

@princepride princepride left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we can remove all test related file if we haven't add any new node. And can we use SeedVR2 as the upscale model?

Comment on lines +51 to +53
## Recorded runtime configuration

The H3 service used vLLM-Omni commit `33fff2155e0bf9bc8688f7ffb92ef508efdf6954` plus the original worktree changes. The ComfyUI extension and E2E runner use this PR on base `58adeec05f151e18542323cb4644b009b83cfef3`, including the interface changes from #7456. The ComfyUI host used commit `cbbc9dab1f03d0d9a6caa8a8be7d77a7e37e1e44`. The server environment contained vLLM `0.29.0+cu129`, PyTorch `2.13.0+cu129`, and NVIDIA driver `570.190`. H3 used two RTX 4090 GPUs with TP2, distributed layerwise offload, eight resident layers and cuDNN attention.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pls remove them, we don't need.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed the recorded runtime configuration and the E2E instructions in cacafda. The document now contains only requirements and workflow usage.

Replace the frame upscaler with existing SeedVR2 nodes, trim workflow
setup notes, and remove the workflow-only validation files.

Signed-off-by: xuezhihao <89690814+xuexueligao@users.noreply.github.com>
@xuexueligao

Copy link
Copy Markdown
Contributor Author

Updated in cacafda: removed the test-related files, shortened the setup notes, and replaced RealESRGAN with SeedVR2 3B FP16 using the existing ComfyUI plugin.

The PR description now includes the updated workflow, ComfyUI screenshots, original video, SeedVR2 output with audio, and side-by-side comparison. The new run preserves all 124 frames, 24 FPS and the generated audio.

…Video Upscale.api.json

Signed-off-by: 汪志鹏 <wangzhipeng628@gmail.com>

@princepride princepride left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@princepride princepride added the ready label to trigger buildkite CI label Sep 15, 2026
@princepride
princepride enabled auto-merge (squash) September 15, 2026 09:24
@princepride
princepride merged commit 4a8ac29 into vllm-project:main Sep 15, 2026
6 of 7 checks passed
mlaneuville pushed a commit to mlaneuville/vllm-omni that referenced this pull request Sep 22, 2026
…t#7472)

Signed-off-by: xuezhihao <89690814+xuexueligao@users.noreply.github.com>
Signed-off-by: 汪志鹏 <wangzhipeng628@gmail.com>
Co-authored-by: 汪志鹏 <wangzhipeng628@gmail.com>
Signed-off-by: Matthieu Laneuville <matthieu.laneuville@surf.nl>
khairulkabir1661 pushed a commit to khairulkabir1661/vllm-omni that referenced this pull request Sep 25, 2026
…t#7472)

Signed-off-by: xuezhihao <89690814+xuexueligao@users.noreply.github.com>
Signed-off-by: 汪志鹏 <wangzhipeng628@gmail.com>
Co-authored-by: 汪志鹏 <wangzhipeng628@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

diffusion codes related to diffusion models enhancement New feature or request frontend code related to entrypoint ready label to trigger buildkite CI

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants