Troubleshooting Guide
Use this guide to identify and resolve common issues when working with the FASHN API.
| Issue | Cause | Solution |
|---|---|---|
{"error": "Job not found"} from https://api.fashn.ai/v1/status/:id | After a request completes, the status information remains available for only 5 minutes. Once that period expires, the job data is discarded, resulting in this error. | Timely Query: Poll the status endpoint within 5 minutes of receiving the ID. Graceful Fallback: If you must wait longer, handle the possibility that the job may no longer exist. |
| API results differ from the Web App | The Web App preprocesses images before sending them to the API, which can lead to different outputs if the same steps are not followed externally. | Preprocessing: See Image Preprocessing Best Practices for instructions on replicating the Web App's steps to ensure consistent results. |
| Error Code 500 (Server Error) | Commonly caused by an oversized payload (e.g., high-resolution, base64-encoded images), preventing the request from reaching our API. | Reduce Payload: See Image Preprocessing Best Practices for recommended steps to avoid large payloads. |