{"record":{"id":"61432600e07caf36","repo":"sgl-project/sglang","slug":"minimax-h3-quality-high-is-validated-only-for","errorCode":null,"errorMessage":"MiniMax-H3 quality=\"high\" is validated only for {_MINIMAX_H3_QUALITY_WORKLOAD}; got {actual}","messagePattern":"MiniMax-H3 quality=\"high\" is validated only for (.+?); got (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"python/sglang/multimodal_gen/runtime/pipelines_core/stages/model_specific_stages/minimax_h3/release_metadata.py","lineNumber":209,"sourceCode":"                \"fps\",\n                \"frame_count\",\n                \"num_inference_steps\",\n            )\n            exact = all(\n                actual[name] == _MINIMAX_H3_QUALITY_WORKLOAD[name]\n                for name in exact_fields\n            )\n            shifts = math.isclose(\n                actual[\"flow_shift\"],\n                _MINIMAX_H3_QUALITY_WORKLOAD[\"flow_shift\"],\n                abs_tol=1e-9,\n            ) and math.isclose(\n                actual[\"audio_flow_shift\"],\n                _MINIMAX_H3_QUALITY_WORKLOAD[\"audio_flow_shift\"],\n                abs_tol=1e-9,\n            )\n            if not exact or not shifts:\n                raise ValueError(\n                    'MiniMax-H3 quality=\"high\" is validated only for '\n                    f\"{_MINIMAX_H3_QUALITY_WORKLOAD}; got {actual}\"\n                )\n        return batch\n\n\n__all__ = [\"MiniMaxH3PartitionAdmissionStage\", \"MiniMaxH3ReleaseMetadata\"]\n","sourceCodeStart":191,"sourceCodeEnd":217,"githubUrl":"https://github.com/sgl-project/sglang/blob/0132848349585cfe6aae51c4941cbae872505f8a/python/sglang/multimodal_gen/runtime/pipelines_core/stages/model_specific_stages/minimax_h3/release_metadata.py#L191-L217","documentation":"quality=\"high\" is only validated for one exact workload (_MINIMAX_H3_QUALITY_WORKLOAD): the request plan's task, dimensions, and flow shifts must match that golden workload within abs_tol=1e-9. Any deviation — wrong dims, task, or shift values — is rejected with the actual workload printed.","triggerScenarios":"A non-warmup quality=\"high\" request whose plan.shape/width/height/flow shifts differ from _MINIMAX_H3_QUALITY_WORKLOAD (e.g. 1024x1024 when only 768x768 was validated).","commonSituations":"Clients requesting high quality at arbitrary resolutions/aspect ratios when only one configuration has been validated; changing default flow-shift hyperparameters in config.","solutions":["Match the exact golden workload in _MINIMAX_H3_QUALITY_WORKLOAD (task, width, height, shifts) when requesting quality=\"high\"","Use quality=\"lossless\" for other shapes until more workloads are validated","Read the actual dict in the error message and diff it against your request parameters"],"exampleFix":"# before\nsampling_params.quality = \"high\"  # width=1024, unvalidated\n# after\nsampling_params.quality = \"high\"  # width/height/shifts == _MINIMAX_H3_QUALITY_WORKLOAD\n# or:\nsampling_params.quality = \"lossless\"","handlingStrategy":"validation","validationCode":"plan = minimax_h3_plan_from_batch(req)\nif quality == \"high\":\n    assert plan is not None and matches_golden(plan, _MINIMAX_H3_QUALITY_WORKLOAD), \\\n        \"high quality only supported for the golden workload\"","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Expose only the validated width/height/shift preset for quality='high'","Fall back to 'lossless' for other shapes"],"tags":["minimax-h3","quality-high","workload-validation","golden-config"],"backgroundTag":"unsupported-configuration","analyzedSha":"0132848349585cfe6aae51c4941cbae872505f8a","analyzedAt":"2026-08-28T05:10:05.995Z","schemaVersion":2},"datasetVersion":"2026-08-28T06:17:29.519Z"}