Gallery & Downloads

Download formats and resolutions

Resolution (1K, 2K, 4K) is set at generation time — there is no separate download-resolution toggle. Files are served as PNG by default; underlying mime-type matches what the model produced. Worker-generated images redirect to a 5-minute presigned S3 URL.

Last updated

Resolution (1K, 2K, 4K) is set at generation time — there is no separate download-resolution toggle. Files are served as PNG by default; the underlying mime-type matches what the model produced. Worker-generated images redirect to a 5-minute presigned S3 URL.

Download endpoint

  • GET /api/gallery/[id]/download
  • Auth: must be the owner. Apiway checks user_id on the gallery row and rejects unauthorized requests.
  • For S3 rows: 302 redirect to a presigned URL valid for 300 seconds (5 minutes).
  • For Supabase rows: stream blob with Content-Disposition: attachment and filename mannequin-{id}.png.

Formats

  • PNG — default for downloads, lossless, larger file size.
  • JPEG — sometimes returned by the model; smaller files. Mime-type follows what the underlying model generated.

Resolutions and how to pick

  • 1K — fastest, lowest cost. Use for testing and concept work.
  • 2K — Shopify-ready. Default for catalog imagery.
  • 4K — print-ready. Use for hero campaigns, billboards, lookbooks. Requires Pro / nano-banano-2.

Bulk / batch download

Bulk export of an entire batch is via the public folder sharing flow — see share via public folder. For a single image, use the per-image download endpoint above.

EXIF and metadata

Apiway does not embed PII in EXIF. Generated images do not contain user-identifying metadata.

Related docs