Endpoints
On this page you will find our HTTP API reference. Currently, we support 3 types of endpoints:
run
- Run predictionstatus/:id
- Get prediction statuscancel/:id
- Cancel prediction
Run prediction
Initiate a new try-on prediction by posting to the following endpoint:
POSThttps://api.fashn.ai/v1/run
Request
Properties:
model_image
Requiredimage URL | base64
garment_image
Requiredimage URL | base64
category
Required'tops' | 'bottoms' | 'one-pieces'
nsfw_filter
boolean
Runs NSFW content filter on inputs.
Default: true
cover_feet
boolean
Allows long garments to cover the feet/shoes or change their appearance.
Default: false
adjust_hands
boolean
Allow to change the appearance of the model’s hands. Example use-cases: Remove gloves, get hands out of pockets, long sleeves that should cover hands.
Default: false
restore_background
boolean
Apply additional steps to preserve the original background. Runtime will be slower. Not needed for simple backgrounds.
Default: false
restore_clothes
boolean
Apply additional steps to preserve the appearance of clothes that weren’t swapped (e.g. keep pants if trying-on top).
Default: false
garment_photo_type
auto | 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
long_top
boolean
Adjusts internal parameters for better performance on long tops such as: Longline shirts, tunics, coats, etc.
Default: false
guidance_scale
float
Higher guidance scales can help with preserving garment detail, but risks oversaturated colors.
Default: 2
Range: 1.5-3
timesteps
int
Determines how many steps the diffusion model will take to generate the image. For simple try-ons, steps can be reduced for faster runtime.
Default: 50
Range: 10-50
seed
int
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
num_samples
int
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
Range: 1-4
Rate limit: 25 generations/minute
Response
The reponse will return the id
of the prediction which you will need to use for getting the status and result or canceling the prediction.
Get prediction status
Receive the status of the prediction by id
. Unless in a queue, it takes
up to 40 seconds to generate a try-on.
GEThttps://api.fashn.ai/v1/status/:id
Poll this endpoint to monitor the prediction’s progress and retrieve the final output once available.
Request
Response
The response will return the prediction id
and status
.
Status types can be one of the following:
status
starting | in_queue | processing | completed | failed | canceled
Prediction in progress
Prediction completed
Cancel prediction
Request to cancel your running prediction.
Error Handling
In case of an error, the API will add the following object to the error
key in the response:
name
PipelineError | RequestError | ImageLoadError | NSFWError | PoseError | InputValidationError | PhotoTypeError
message
string
Example:
Example of an error when polling the /status
endpoint:
If you encounter an unrecognized error, please contact us at support@fashn.ai.