Skip to main content
HTTP Status: 502, 503 or 504

Reasons and How to Fix

Temporary Processing Failure

The API gateway could not get a result from the image processing service. The status tells you why: All three are transient and safe to retry. The failed request is not billed. To fix:
  1. Wait a few seconds and retry the request
  2. Use exponential backoff for automatic retries
  3. Check status.poof.bg for any ongoing incidents

Retry Strategy

Persistent Failures on One Image

If only a specific image keeps failing, the problem is usually the image itself, and you will typically see invalid_image or processing_failed instead. To fix:
  • Verify the image opens correctly in an image viewer
  • Try converting to a standard JPEG or PNG
  • Try a smaller version of the image

Service Status

Check status.poof.bg for real-time service status and incident reports.

Need Help?

If the issue persists, contact us at support@poof.bg with your request_id and the image (if possible).