Nightly
The /nightly endpoint provides preview access to our latest v1.5 experimental model.
This version introduces a major change: most control parameters have been deprecated in favor of a simplified, more powerful approach.
To use it, simply run https://api.fashn.ai/nightly/[run or status]
New Parameter: segmentation_free
Segmentation-Free Mode fits garments directly onto models without explicit clothing segmentation. It enables trying bulkier or looser garments over tighter original outfits and improves preservation of body shape, skin texture, and other model characteristics.
Enabled by default, it can be disabled if original garments are not properly removed.
Properties
model_imageRequiredimage URL | base64 | string
Primary image of the person on whom the virtual try-on will be performed.
Models Studio users can use their saved models by passing saved:<model_name>.
garment_imageRequiredimage URL | base64
Reference image of the clothing item to be tried on the model_image.
category'auto' | 'tops' | 'bottoms' | 'one-pieces'
Use auto to enable automatic classification of the garment type. For flat-lay or ghost mannequin images, the system detects the garment type automatically. For on-model images, full-body shots default to a full outfit swap. For focused shots (upper or lower body), the system selects the most likely garment type (tops or bottoms).
Default: auto
segmentation_freeboolean
Direct garment fitting without clothing segmentation, enabling bulkier garment try-ons with improved preservation of body shape and skin texture. Set to false if original garments are not removed properly.
Default: true
moderation_level'conservative' | 'permissive' | 'none'
Sets the content moderation level for garment images.
-conservative enforces stricter modesty standards suitable for culturally sensitive contexts. Blocks underwear, swimwear, and revealing outfits.
-permissive allows swimwear, underwear, and revealing garments, while still blocking explicit nudity.
-none disables all content moderation
Default: permissive
This technology is designed for ethical and appropriate virtual try-on applications. Misuse—such as generating inappropriate imagery of individuals without consent—violates our Terms of Service.
Setting moderation_level: none does not absolve users from their responsibility to ensure ethical and lawful use. Violations may result in service denial.
garment_photo_typeauto | flat-lay | model
Specifies the type of garment photo to optimize internal parameters for better performance. 'model' is for photos of garments on a model, 'flat-lay' is for flat-lay or ghost mannequin images, and 'auto' attempts to automatically detect the photo type.
Default: auto
modeperformance | balanced | quality
Specifies the mode of operation.
-performance mode is faster but may compromise quality
-balanced mode is a perfect middle ground between speed and quality
-quality mode is slower, but delivers the highest quality results.
Default: balanced
seedint
Sets random operations to a fixed state. Use the same seed to reproduce results with the same inputs, or different seed to force different results.
Default: 42
Min: 0
Max: 2^32 - 1
num_samplesint
Number of images to generate in a single run. Image generation has a random element in it, so trying multiple images at once increases the chances of getting a good result.
Default: 1
Min: 1
Max: 4
Deprecated parameters
• restore_background
• adjust_hands
• cover_feet
• restore_clothes
• long_top