Image Upload Issues

Common Causes

Image upload failures are usually caused by one of three things: the file is too large, the format is unsupported, or a network issue interrupted the transfer. This guide walks through each scenario and its fix.

File Size Limits

The maximum file size is 20 MB per image. If your image exceeds this limit, resize or compress it before uploading. Tools like TinyPNG, ImageOptim, or the sharp Node.js library can reduce file size without noticeable quality loss.

For batch uploads via the API, the total request size must not exceed 50 MB. Split larger batches into multiple requests.

Format Issues

huhu.ai supports JPEG, PNG, and WebP. Other formats such as TIFF, BMP, HEIC, or SVG are not currently supported. Convert unsupported files using an image editor or command-line tool like ImageMagick before uploading.

Ensure the file extension matches the actual file format. Renaming a TIFF file to .jpg does not convert it and will result in a parsing error.

Network Issues

If your upload stalls or times out, check your internet connection and try again. Large files on slow connections may benefit from the API's resumable upload endpoint, which supports chunked uploads and automatically resumes from the last successful chunk.

Corporate firewalls or proxy servers may block large multipart requests. If uploads fail consistently from a corporate network, ask your IT team to whitelist upload.huhu.ai.