sgl-project/sglang · error · RuntimeError

MiniMax H3 material localization completed without cached pr

Error message

MiniMax H3 material localization completed without cached probe facts

What it means

After localization succeeded, the probe facts expected under MINIMAX_H3_MATERIAL_PROBE_EXTRA_KEY for (uri, condition_type) are missing or empty. This is an internal pipeline-state inconsistency, not user input.

Source

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

def minimax_h3_probe_material(
    batch: Any,
    uri: str,
    *,
    condition_type: str,
    condition_index: int,
) -> dict[str, Any]:
    """Localize and return cached display-geometry facts for one condition."""

    path = minimax_h3_localize_material_uri(
        batch,
        uri,
        condition_type=condition_type,
        condition_index=condition_index,
    )
    key = (uri, condition_type)
    facts = batch.extra.get(MINIMAX_H3_MATERIAL_PROBE_EXTRA_KEY, {}).get(key)
    if not isinstance(facts, dict) or not facts:
        raise RuntimeError(
            "MiniMax H3 material localization completed without cached probe facts"
        )
    return {"local_path": path, **facts}


__all__ = [
    "MINIMAX_H3_MATERIAL_CACHE_EXTRA_KEY",
    "MINIMAX_H3_MATERIAL_PROBE_EXTRA_KEY",
    "MINIMAX_H3_TEMP_DIRS_EXTRA_KEY",
    "minimax_h3_cleanup_temp_dirs",
    "minimax_h3_localize_material_uri",
    "minimax_h3_probe_material",
    "minimax_h3_register_temp_dir",
]

View on GitHub (pinned to 0132848349)

Solutions

1. Ensure the standard minimax_h3 localization path populated batch.extra before probing
2. Upgrade/rebuild the pipeline so probe and localize stages match
3. Report a bug if it occurs with unmodified code

except RuntimeError as e: fail fast and report pipeline bug; do not retry

When it happens

Trigger: minimax_h3_probe_material called on a batch where localization happened through a path that bypassed the probe-facts writer (custom monkeypatching, partial state restore, or a bug).

Common situations: Almost always a code/version bug or tests constructing batches manually without running the probe stage.

Related errors

• fl2va requires first_frame, last_frame, or both
• ref2va requires at least one of reference_image, reference_v
• t2va takes no conditioning inputs; pick another task
• MiniMax-H3 quality="high" is validated only for the strict 4
• MiniMax-H3 on MPS requires synchronous layerwise offload for

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