ItemlumePRODUCT CREATIVE / PRODUCTION AND HANDOFF
Why Does FASHN Reframe Return InputValidationError When My Product Image Is Already 4:5?
Check whether the source already matches the requested aspect ratio. FASHN Reframe can return InputValidationError when the image already has the target ratio. That does not mean every InputValidationError has this cause. Confirm the dimensions and error details before changing the image or resubmitting.
Check Whether Reframing Is Necessary
FASHN Reframe is designed to change image composition toward a requested aspect ratio, choosing between expansion and cropping according to the image. It is not a general-purpose tool for changing a product's pose while preserving an identical canvas ratio.
Before submitting a merchant asset, calculate its existing width-to-height relationship. If it already matches the approved target, record that no ratio change is required. This simple eligibility check can prevent an unnecessary processing request and a misleading troubleshooting cycle.
Interpret InputValidationError Carefully
The official Reframe documentation identifies an already-matching target ratio as a possible InputValidationError condition. Other input-validation problems can also produce that error category.
Record the source file identifier and actual width×height, the submitted target ratio, and the complete error text with its request record. If the ratios match, investigate the documented no-change condition. If they differ, inspect the specific validation details and the documented input limits; do not attribute every InputValidationError to the ratio or invent a new target merely to make the request run.
Illustrative Exercise: Two Product Images
Illustrative exercise, not an executed API request: compare source width W and height H with target 4:5. Exact mathematical equality can be checked as W×5=H×4. This arithmetic does not establish an undocumented service tolerance or prove the cause of a returned error.
| Fictional input | Arithmetic check | Decision |
|---|---|---|
| 1200×1500 → 4:5 | 1200/1500=4/5; 1200×5=1500×4=6000 | No ratio change is needed; check the specific no-change error if one was returned |
| 1000×1500 → 4:5 | 1000/1500=2/3; 1000×5=5000, 1500×4=6000 | Ratios differ; inspect actual validation details before deciding on another request |
Check the documented no-change error and input limits in FASHN Reframe validation guidance; not every InputValidationError has the same cause.
Before changing the request, distinguish aspect ratio from pixel resolution and inspect the actual source file dimensions.
Separate Geometry Requirements From Creative Changes
A merchant might request Reframe because the existing image feels poorly composed, even though its dimensions already meet the publishing specification. That is a different production problem. Document whether the desired change concerns canvas geometry, product placement, or the surrounding scene.
For a genuinely different target ratio, define which product regions must remain visible and what cropping or expansion would be acceptable. Review the resulting composition separately if processing proceeds.
For an already-matching ratio, return the request to the creative brief rather than inventing another target merely to bypass validation. This guide uses the documented Experimental Reframe behavior released August 14, 2025; the fictional examples establish decisions, not tested service outcomes.
Reframe geometry and validation record — complete with actual observations
Save a copy of this record and enter actual inputs, actions and observations. Keep incomplete checks pending; do not prefill success.
| Record | Actual value to complete |
|---|---|
| Source file/version and actual width×height | |
| Approved target ratio and required creative change | |
| Ratio calculation or cross-product check | |
| Actual submitted aspect_ratio and request-record location | |
| Complete error text and observation time, if returned | |
| Other reported input-validation issue | |
| Acceptable crop/expansion and required visible product regions | |
| Actual output identifier/dimensions, only if produced | |
| Unresolved issue and review status |
Sources and further reading
Recorded source-review dates are listed individually below. An undated source does not inherit the article’s publication date. Software and platform rules can change; check the current original before acting.
- Reframe — FASHN documentation · Reviewed
Frequently asked questions
Does every FASHN InputValidationError mean the image already matches the target ratio?
No. An already-matching ratio is one documented cause. Other validation conditions may produce the same error category, so inspect the specific request and error details.
Should I change a correct 4:5 image to another ratio just to make Reframe run?
No. First determine whether the merchant actually needs a different composition or canvas ratio. Do not introduce an unnecessary geometry change merely to avoid a validation condition.
PREPARE ASSETS FOR YOUR NEXT STEP
Create supporting product assets in Itemlume.
Create new product creative assets in the workspace, then continue in your chosen tools. Third-party software procedures described in this guide take place in those applications; this workspace link does not imply an integration. Check current capabilities, account access and credit quotes.
Explore asset creation tools Check pricing and credits