Files

Zustack supports only images and videos as file types.

Images

Images can be automatically optimized and converted to WebP format to improve latency, reduce bandwidth costs, and enhance delivery performance.

Videos

Videos are converted to HLS (HTTP Live Streaming) format for efficient streaming and adaptive quality. Zustack videos support modern player features such as:

• Thumbnails
• Timeline previews
• Multiple quality levels

These features provide a smooth and interactive viewing experience, comparable to any modern video player.

---

Supported File Types

Images:

• image/jpeg
• image/png
• image/webp
• image/gif

Videos:

• video/mp4
• video/webm
• video/ogg
• video/x-matroska
• video/quicktime

---

Access Control: Public vs Private Files

Files can be either public or private.

• To access private files, you must generate a JWT signed using your bucket’s API key.
• The JWT should include an expiration time (exp) and it is recommended to assign the scope claim as "read" to limit permissions appropriately.
• To access a private file, include the JWT as a URL parameter: https://assets.zustack.com/path/to/image.webp?jwt=YOUR_JWT