{"record":{"id":"d122d5ddebf2874e","repo":"sgl-project/sglang","slug":"unsupported-minimax-h3-model-variant-variant-r","errorCode":null,"errorMessage":"unsupported MiniMax H3 model variant {variant!r}; supported: {sorted(subfolders)!r}","messagePattern":"unsupported MiniMax H3 model variant (.+?); supported: (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"python/sglang/multimodal_gen/runtime/pipelines/minimax_h3_pipeline.py","lineNumber":82,"sourceCode":"                    \"and validated output delivery; missing executables: \"\n                    f\"{', '.join(missing_media_tools)}. Install the ffmpeg system \"\n                    \"package before starting SGLang.\"\n                )\n        super().__init__(*args, **kwargs)\n\n    @staticmethod\n    def model_subfolder_for_variant(variant: str) -> str:\n        if not isinstance(variant, str) or not variant.strip():\n            raise ValueError(\"MiniMax H3 model variant must be a non-empty string\")\n        normalized = variant.strip().lower()\n        subfolders = {\n            \"fl2va\": \"FL2VA\",\n            \"ref2va\": \"Ref2VA\",\n        }\n        try:\n            return subfolders[normalized]\n        except KeyError as exc:\n            raise ValueError(\n                f\"unsupported MiniMax H3 model variant {variant!r}; \"\n                f\"supported: {sorted(subfolders)!r}\"\n            ) from exc\n\n    def _load_config(self):\n        model_variant = self.server_args.model_variant\n        if model_variant is not None:\n            semantic_subfolder = self.model_subfolder_for_variant(model_variant)\n            explicit_subfolder = self.server_args.model_subfolder\n            if (\n                explicit_subfolder is not None\n                and explicit_subfolder.strip().lower() != semantic_subfolder.lower()\n            ):\n                raise ValueError(\n                    \"MiniMax H3 --model-variant and --model-subfolder select \"\n                    f\"different weight partitions: variant={model_variant!r} maps to \"\n                    f\"{semantic_subfolder!r}, model_subfolder=\"\n                    f\"{explicit_subfolder!r}\"","sourceCodeStart":64,"sourceCodeEnd":100,"githubUrl":"https://github.com/sgl-project/sglang/blob/0132848349585cfe6aae51c4941cbae872505f8a/python/sglang/multimodal_gen/runtime/pipelines/minimax_h3_pipeline.py#L64-L100","documentation":"Raised by MiniMaxH3Pipeline.model_subfolder_for_variant for a non-empty variant string that, after strip+lowercase normalization, is not one of the known partitions (fl2va -> FL2VA, ref2va -> Ref2VA). The error lists the supported variant keys to make correction immediate.","triggerScenarios":"Passing --model-variant FL2VA_V2, 'vl' or any misspelling like 'fl2v'; case/format variants are fine (normalization handles them) but unknown names raise; new partitions added upstream while the running sglang version predates them.","commonSituations":"Typos in launch flags or Helm values; copying a variant name from a different model family; sglang version older than the checkpoint's new partition names.","solutions":["Use exactly 'fl2va' or 'ref2va' (case-insensitive) as printed in the error's supported list","If you expected a newer partition name, upgrade sglang so model_subfolder_for_variant knows it","Omit --model-variant and set --model-subfolder directly if you know the raw subfolder name"],"exampleFix":"# before\npython -m sglang.launch_server --model minimax-h3 --model-variant fl2v\n\n# after\npython -m sglang.launch_server --model minimax-h3 --model-variant fl2va","handlingStrategy":"validation","validationCode":"variant = server_args.model_variant.strip().lower()\nif variant not in ('fl2va', 'ref2va'):\n    raise SystemExit(f'unsupported --model-variant {variant!r}; use fl2va or ref2va')","typeGuard":"def is_supported_minimax_variant(v: str) -> bool:\n    return (v or '').strip().lower() in ('fl2va', 'ref2va')","tryCatchPattern":null,"preventionTips":["Pin supported variants in your deployment config schema","Upgrade sglang alongside new checkpoint partitions"],"tags":["minimax-h3","model-variant","unsupported-value","sglang"],"backgroundTag":"invalid-config-value","analyzedSha":"0132848349585cfe6aae51c4941cbae872505f8a","analyzedAt":"2026-08-28T05:10:05.995Z","schemaVersion":2},"datasetVersion":"2026-08-28T06:17:29.519Z"}