Invalid Image - Poof

HTTP Status: 422

{
  "code": "invalid_image",
  "message": "The file could not be decoded as an image. Send JPEG, PNG, WebP or a still GIF.",
  "request_id": "req_3f6a2c1e-9b0d-4e7a-8c21-5d1f0a9b7e42",
  "doc_url": "https://docs.poof.bg/errors/invalid-image"
}

Reasons and How to Fix

Unsupported Format

Only PNG, JPEG, WebP and still (single-frame) GIF are accepted as images. HEIC, TIFF, BMP, SVG, PDF and other formats are rejected. An animated GIF (two or more frames) is not an image: it is processed as a video and returns a job. To fix:

Convert the image to JPEG, PNG, WebP or a still GIF before uploading (PNG keeps the transparency)

from PIL import Image

img = Image.open("photo.heic")  # requires pillow-heif for HEIC
img.convert("RGB").save("photo.jpg", quality=90)

# Using ImageMagick
convert photo.tiff photo.png

Corrupted or Truncated File

The file may have been cut off during download or upload, or is not an image at all. To fix:

Verify the file opens correctly in an image viewer
Re-download or re-export the source image
Check that you are sending the file bytes, not a path string or base64 text

# ❌ Wrong - sends the literal text "photo.jpg"
-F "file=photo.jpg"

# ✅ Correct - sends the file contents
-F "file=@photo.jpg"

Wrong Extension

The content type is detected from the file bytes, not the extension. Renaming a .gif to .png does not make it a PNG.

Need Help?

Contact us at support@poof.bg with your request_id and the image (if possible).