{"record":{"id":"dbff7511bd7bcb7e","repo":"Comfy-Org/ComfyUI","slug":"bria-can-upscale-up-to-a-maximum-output-dimension","errorCode":null,"errorMessage":"Bria can upscale up to a maximum output dimension of {BRIA_MAX_OUTPUT_SIDE} pixels: input is {width}x{height}, x{multiplier} would be {predicted} pixels on the long side. Enable auto_downscale, or use a smaller input image or a lower multiplier.","messagePattern":"Bria can upscale up to a maximum output dimension of (.+?) pixels: input is (.+?)x(.+?), x(.+?) would be (.+?) pixels on the long side\\. Enable auto_downscale, or use a smaller input image or a lower multiplier\\.","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"comfy_api_nodes/nodes_bria.py","lineNumber":725,"sourceCode":"                expr=\"\"\"{\"type\":\"usd\",\"usd\":0.0286}\"\"\",\n            ),\n        )\n\n    @classmethod\n    async def execute(\n        cls,\n        image: Input.Image,\n        desired_increase: str,\n        auto_downscale: bool,\n        moderation: dict,\n    ) -> IO.NodeOutput:\n        multiplier = int(desired_increase)\n        height, width = get_image_dimensions(image)\n        if _upscaled_output_side(height, width, multiplier) > BRIA_MAX_OUTPUT_SIDE:\n            candidates = [c for c in (4, 2) if c <= multiplier]\n            if not auto_downscale:\n                predicted = _upscaled_output_side(height, width, multiplier)\n                raise ValueError(\n                    f\"Bria can upscale up to a maximum output dimension of {BRIA_MAX_OUTPUT_SIDE} pixels: \"\n                    f\"input is {width}x{height}, x{multiplier} would be {predicted} pixels on the long side. \"\n                    f\"Enable auto_downscale, or use a smaller input image or a lower multiplier.\"\n                )\n            fitted = next(\n                (c for c in candidates if _upscaled_output_side(height, width, c) <= BRIA_MAX_OUTPUT_SIDE), None\n            )\n            if fitted is not None:\n                multiplier = fitted\n            else:\n                shrinkable = next((c for c in sorted(candidates) if _smallest_output_side(height, width, c)\n                                   <= BRIA_MAX_OUTPUT_SIDE), None)\n                if shrinkable is None:\n                    raise ValueError(\n                        f\"This image cannot be upscaled by Bria at any multiplier: it is {width}x{height}, and \"\n                        f\"Bria first enlarges the short side to {BRIA_MIN_SHORT_SIDE} pixels, which pushes the \"\n                        f\"long side past the {BRIA_MAX_OUTPUT_SIDE} pixel limit. Crop it to a squarer shape first.\"\n                    )","sourceCodeStart":707,"sourceCodeEnd":743,"githubUrl":"https://github.com/Comfy-Org/ComfyUI/blob/1c6d8d45b3693bfbb32385b410d813a7fd6be216/comfy_api_nodes/nodes_bria.py#L707-L743","documentation":"Bria's upscaler caps output at BRIA_MAX_OUTPUT_SIDE pixels on the long side. The node predicts the long side after the x-multiplier and, if it exceeds the cap and auto_downscale is off, raises instead of letting the API fail. The message names the input size, multiplier, and predicted side.","triggerScenarios":"desired_increase parsed as multiplier N; _upscaled_output_side(height, width, N) > BRIA_MAX_OUTPUT_SIDE; auto_downscale widget is false. E.g. a 6000px-long image at x4.","commonSituations":"User upscales an already-high-resolution render; multiplier widget left at 4 from a small-image workflow; unaware of the output-side cap.","solutions":["Enable the auto_downscale input: the node then picks the largest fitting multiplier (4 or 2) or downscales the input first.","Lower the desired_increase multiplier so the predicted long side fits.","Feed a smaller input image (downscale before the node)."],"exampleFix":"// before\nauto_downscale: false, desired_increase: '4'\n// after\nauto_downscale: true, desired_increase: '4'","handlingStrategy":"validation","validationCode":"long_side = max(get_image_dimensions(image))\nif long_side * multiplier > BRIA_MAX_OUTPUT_SIDE:\n    multiplier = next(m for m in (multiplier, 4, 2) if long_side * m <= BRIA_MAX_OUTPUT_SIDE)","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Leave auto_downscale enabled unless you need an exact multiplier.","Compute max(long_side) * multiplier against the cap before queueing large inputs."],"tags":["comfyui","bria","upscale","limits","validation"],"backgroundTag":null,"analyzedSha":"1c6d8d45b3693bfbb32385b410d813a7fd6be216","analyzedAt":"2026-08-14T19:37:18.893Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}