Separate the submitted reference from the requested output
When a virtual try-on request fails before producing an image, inspect the input files rather than increasing output resolution. A merchant may assume that requesting a larger result gives the service more freedom to interpret a small or unusually shaped reference. That reverses the actual dependency: the service must first accept the submitted images before output settings become relevant.
For Try-On Max, examine both the product reference and the target model photograph. Record their actual encoded dimensions, file sizes, and aspect ratios. Do not use the dimensions of a thumbnail displayed in a browser or product-management interface; inspect the file actually supplied to the request.
FASHN's current Try-On Max reference specifies the input boundaries independently of output resolution. An error outside those boundaries is an input problem, not evidence that 4K generation is unavailable.
Identify which condition fails
Measure each actual submitted file, not a browser thumbnail: encoded byte size, pixel width and pixel height. Retain the complete returned validation details; the documented size and ratio bounds are not the only possible input problem.
Use the full validation error when available. If an image is oversized in bytes, investigate the encoded file rather than its apparent canvas size alone. If a dimension is below the minimum, determine whether the original source exists at a suitable resolution. If the aspect ratio is outside the accepted interval, ask whether the submitted file is an accidentally narrow crop or an intentionally panoramic reference.
Do not repair an extremely narrow garment photograph by stretching it horizontally. Stretching may produce acceptable arithmetic while changing the depicted garment. Similarly, enlarging a tiny image does not restore missing stitching, print, or closure details.
For an input that satisfies the technical limits but still fails, preserve the exact error and investigate other documented validation conditions. InputValidationError is a category, not a guarantee that one of these three measurements is responsible.
Illustrative case: a narrow scarf reference
A 120-by-2400-pixel image is 1:20. It exceeds the permitted ratio range even though both dimensions exceed 15 pixels. These are separate checks.
A fictional accessories seller wants a model image wearing a patterned scarf. The source file is 120 × 2400 pixels, approximately a 1:20 aspect ratio. The merchant requests 4K output.
The aspect ratio falls outside the documented 1:16 lower boundary. Increasing the output tier cannot repair that submitted geometry. The seller has a second approved photograph showing the entire scarf with useful surrounding space and a less extreme aspect ratio.
The correct editorial branch is to inspect that second source, not to stretch the first image or assume the model will reconstruct the missing context. If the second file meets the input contract, it becomes an eligible candidate for submission, but no generation result is predicted.
| Finding | Next action |
|---|---|
| File exceeds the documented byte limit | Prepare an appropriately encoded source while retaining needed detail |
| Width or height below the minimum | Find a suitable original capture |
| Aspect ratio outside the accepted range | Choose a legitimate alternative crop or source |
| All three checks pass | Inspect the actual remaining validation details |
Distinguish eligibility from production quality
A 15 × 15-pixel image may satisfy the numerical floor but cannot be assumed suitable for evaluating fabric texture or printed graphics. A source that technically passes may still leave the product's defining features unobservable. Conversely, a high-resolution file may fail because its encoded size exceeds the limit.
Decide source suitability from the garment features the buyer must see, not from the service's smallest accepted dimensions. The existing FASHN Reframe validation guide addresses a different endpoint and a different already-matching-ratio condition; do not transfer that explanation to Try-On Max.
Close the validation record
Keep the submitted file identifiers, measured dimensions, encoded sizes, calculated aspect ratios, requested output tier, and complete error response. Record whether a replacement source was selected or whether the task remains blocked by missing garment evidence.
Exit the input-diagnosis stage only when the submitted files satisfy the documented limits and any remaining validation error has been identified separately. Successful input validation is not approval of the eventual try-on image.