sgl-project/sglang · error · ValueError

MiniMax H3 video material has no usable frame rate

Error message

MiniMax H3 video material has no usable frame rate

What it means

The MiniMax H3 video material has no usable frame rate. Re-encode the video with a valid fps.

Solutions

  1. Re-encode forcing a frame rate: ffmpeg -i in.mp4 -r 30 -c:v libx264 out.mp4
  2. If the file is really a single image, submit it as an image material instead
  3. Check ffprobe avg_frame_rate and fix at the producing side

Example fix

# before
ffmpeg -i slides.mkv -c copy out.mkv   # r_frame_rate 0/0
# after
ffmpeg -i slides.mkv -r 25 -c:v libx264 out.mp4
Defensive patterns

Strategy: validation

Validate before calling

def fps_ok(s):
    num, _, den = str(s.get("avg_frame_rate") or s.get("r_frame_rate") or "0/0").partition("/")
    try:
        return int(den or 1) != 0 and int(num) / int(den) > 0
    except (ValueError, ZeroDivisionError):
        return False
assert all(fps_ok(s) for s in video_streams)

Prevention

When it happens

Trigger: Streams where ffprobe reports avg_frame_rate '0/0' and r_frame_rate '0/0' — common for single-frame streams, some VFR/concat outputs, and attached pictures.

Common situations: Slideshows/exported stills, concat demuxer outputs, streams from some screen recorders.

Related errors


AI-assisted analysis of sgl-project/sglang@0132848349 (2026-08-28). Data as JSON: /api/errors/e0172d7162d1303c. Report an issue: GitHub.

Appendix: source

Thrown at python/sglang/multimodal_gen/runtime/pipelines_core/stages/model_specific_stages/minimax_h3/material_io.py:443

    if condition_type in {"audio", "video_audio"} and not audio_streams:
        raise ValueError("MiniMax H3 audio material has no audio stream")

    primary_video: dict[str, Any] | None = None
    for stream in video_streams:
        try:
            width = int(stream.get("width") or 0)
            height = int(stream.get("height") or 0)
        except (TypeError, ValueError) as exc:
            raise ValueError(
                "MiniMax H3 video material has invalid dimensions"
            ) from exc
        if width <= 0 or height <= 0:
            raise ValueError("MiniMax H3 video material has no positive dimensions")
        fps = _parse_frame_rate(stream.get("avg_frame_rate")) or _parse_frame_rate(
            stream.get("r_frame_rate")
        )
        if fps <= 0:
            raise ValueError("MiniMax H3 video material has no usable frame rate")
        if primary_video is None:
            primary_video = stream

    for stream in audio_streams:
        try:
            sample_rate = int(stream.get("sample_rate") or 0)
            channels = int(stream.get("channels") or 0)
        except (TypeError, ValueError) as exc:
            raise ValueError("MiniMax H3 audio material has invalid metadata") from exc
        if sample_rate <= 0:
            raise ValueError("MiniMax H3 audio material has no usable sample rate")
        if channels <= 0:
            raise ValueError("MiniMax H3 audio material has no usable channel count")

    durations: list[float] = []
    for value in [
        (payload.get("format") or {}).get("duration"),
        *(stream.get("duration") for stream in streams),

View on GitHub (pinned to 0132848349)