{"record":{"id":"5b27ddd4b9abf529","repo":"AUTOMATIC1111/stable-diffusion-webui","slug":"could-not-find-checkpoint-with-name-p-refiner-che","errorCode":null,"errorMessage":"Could not find checkpoint with name {p.refiner_checkpoint}","messagePattern":"Could not find checkpoint with name (.+?)","errorType":"validation","errorClass":"Exception","httpStatus":null,"severity":"error","filePath":"modules/processing.py","lineNumber":885,"sourceCode":"        assert(len(p.prompt) > 0)\r\n    else:\r\n        assert p.prompt is not None\r\n\r\n    devices.torch_gc()\r\n\r\n    seed = get_fixed_seed(p.seed)\r\n    subseed = get_fixed_seed(p.subseed)\r\n\r\n    if p.restore_faces is None:\r\n        p.restore_faces = opts.face_restoration\r\n\r\n    if p.tiling is None:\r\n        p.tiling = opts.tiling\r\n\r\n    if p.refiner_checkpoint not in (None, \"\", \"None\", \"none\"):\r\n        p.refiner_checkpoint_info = sd_models.get_closet_checkpoint_match(p.refiner_checkpoint)\r\n        if p.refiner_checkpoint_info is None:\r\n            raise Exception(f'Could not find checkpoint with name {p.refiner_checkpoint}')\r\n\r\n    if hasattr(shared.sd_model, 'fix_dimensions'):\r\n        p.width, p.height = shared.sd_model.fix_dimensions(p.width, p.height)\r\n\r\n    p.sd_model_name = shared.sd_model.sd_checkpoint_info.name_for_extra\r\n    p.sd_model_hash = shared.sd_model.sd_model_hash\r\n    p.sd_vae_name = sd_vae.get_loaded_vae_name()\r\n    p.sd_vae_hash = sd_vae.get_loaded_vae_hash()\r\n\r\n    modules.sd_hijack.model_hijack.apply_circular(p.tiling)\r\n    modules.sd_hijack.model_hijack.clear_comments()\r\n\r\n    p.fill_fields_from_opts()\r\n    p.setup_prompts()\r\n\r\n    if isinstance(seed, list):\r\n        p.all_seeds = seed\r\n    else:\r","sourceCodeStart":867,"sourceCodeEnd":903,"githubUrl":"https://github.com/AUTOMATIC1111/stable-diffusion-webui/blob/82a973c04367123ae98bd9abdf80d9eda9b910e2/modules/processing.py#L867-L903","documentation":"At the start of process_images, if p.refiner_checkpoint is set (not None/''), sd_models.get_closet_checkpoint_match is used to resolve it to a CheckpointInfo; when no loaded-or-known checkpoint matches the string, None is returned and this Exception stops the run. It guards against a stale or mistyped refiner model name in the generation request.","triggerScenarios":"Sending a txt2img request with refiner_checkpoint: 'sd_x_refiner_1.5' when no checkpoint with that name/hash/substring exists in models/Stable-diffusion (not downloaded, deleted, or misspelled).","commonSituations":"Refiner model was removed from the models directory but still selected in saved defaults; name typo in an API call; shared config where the refiner exists on one machine but not another.","solutions":["Download or restore the refiner checkpoint .safetensors/.ckpt into models/Stable-diffusion and refresh the checkpoint list.","Or clear the refiner selection (refiner_checkpoint: null / 'None' / '') if you don't want the refiner pass.","Use the exact title shown in the UI checkpoint dropdown; get_closet_checkpoint_match does substring/hash matching, so a distinctive substring of the real filename works."],"exampleFix":"# before\np.refiner_checkpoint = 'sd_xl_refiner_1.0'   # not on disk -> Exception\n\n# after\np.refiner_checkpoint = None                    # skip refiner pass","handlingStrategy":"validation","validationCode":"from modules import sd_models\n\ndef resolve_refiner(name):\n    if name in (None, '', 'None', 'none'):\n        return None\n    info = sd_models.get_closet_checkpoint_match(name)\n    if info is None:\n        raise ValueError(f'refiner {name!r} not present; download it or clear the field')\n    return info\n\np.refiner_checkpoint = resolve_refiner(p.refiner_checkpoint)","typeGuard":"def checkpoint_exists(name: str) -> bool:\n    return sd_models.get_closet_checkpoint_match(name) is not None","tryCatchPattern":"try:\n    processed = process_images(p)\nexcept Exception as e:\n    if 'Could not find checkpoint' in str(e) and 'refiner' not in str(e):\n        # message contains the refiner name; null it and retry without the refine pass\n        p.refiner_checkpoint = None\n        processed = process_images(p)\n    else:\n        raise","preventionTips":["Validate refiner_checkpoint against the checkpoint list before submitting jobs.","Clear saved refiner selection after deleting models from models/Stable-diffusion."],"tags":["refiner","checkpoint","processing","model-files"],"backgroundTag":null,"analyzedSha":"82a973c04367123ae98bd9abdf80d9eda9b910e2","analyzedAt":"2026-08-14T16:46:43.225Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}