Errors

This guide provides an overview of error codes and how to handle errors when using the API.

If you encounter failed predictions from the /status endpoint, refer to this guide for details on runtime errors.

Common API Errors

Code	Cause	Solution
400 - `BadRequest`	The request is invalid or improperly formatted.	Check the API documentation and ensure the request follows the correct format and includes all required parameters.
401 - `UnauthorizedAccess`	The API key is invalid, inactive, or missing in the request.	Double-check your API key and ensure it is included in the request headers under "Authorization". (See Authentication)
404 - `NotFound`	The requested resource could not be found, or the requested prediction status is no longer tracked.	Double-check the URL or endpoint. If it's due to an untracked prediction ID, a corresponding message will appear.
429 - `RateLimitExceeded`	Too many requests were made in a short period.	Implement request throttling and respect the API rate limits. Wait before retrying.
429 - `OutOfCredits`	You've used up all your API credits.	Check your account's API usage. Purchase more credits if needed.
500 - `InternalServerError`	A server error occurred while processing the request.	Retry the request after some time. If the issue persists, contact support@fashn.ai.

If an error occurs during inference (while running the model), the API will return a 200 status code with a prediction status: failed. Additionally, an error object will be included under the error key in the response.

Name	Cause	Solution
`ImageLoadError`	The pipeline was unable to load the model or garment image from the provided inputs.	For Image URLs: Ensure the URL is publicly accessible and not restricted by permissions. Verify that the Content-Type header specifies the correct image format (e.g., image/jpeg, image/png). For Base64-encoded images: Prefix the string with data:image/`format`;base64, where format is the image type (e.g., jpeg, png).
`ContentModerationError`	Prohibited content detected in the provided garment image based on your current moderation settings.	If your use case allows, adjust `moderation_level` to `permissive` or `none`. Setting `moderation_level: none` disables content moderation but does not remove your responsibility to ensure ethical and lawful use, as outlined in our Terms of Service. Misuse of this technology—such as generating inappropriate imagery of individuals without consent—may result in service denial.
`PhotoTypeError`	The `garment_photo_type` or `category` parameter is set to `auto`, but the system could not automatically determine the garment's image type (flat-lay/model) or its garment category (tops, bottoms, one-pieces).	Explicitly specify `garment_photo_type` as either `flat-lay` or `model`, and/or manually set the garment `category` to `tops`, `bottoms`, or `one-pieces`. Alternatively, improve the garment image clarity or composition following our suggested guidelines.
`PoseError`	The pipeline was unable to detect a body pose in either the model image or the garment image (if the `garment_photo_type` is set to `model`).	Improve the quality of the model or garment image by following our model photo guidelines.
`PipelineError`	An unexpected error occurred during the execution of the pipeline.	Retry the request (you will not be charged for failed attempts). If the issue persists, please reach out to us at support@fashn.ai and include the request ID from the failed attempt to help us locate and address the issue promptly.

The Error Object

{
  "error": {
    "name": "PhotoTypeError",
    "message": "The error message"
  }
}

Example of an error when polling the /status endpoint:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1-u1",
  "status": "failed",
  "error": {
    "name": "ImageLoadError",
    "message": "Error loading model image: The URL's Content-Type is not an image. Content-Type: text/plain;charset=UTF-8"
  }
}

If you encounter an unrecognized error, please contact us at support@fashn.ai.

Errors

Common API Errors

Runtime Errors

The Error Object

On this page