Cosmos is a public image server hosted on AWS, delivering both static and dynamically generated images globally with low latency.
Supported Request Formats
Cosmos requests are expected to take one of the following formats:
- https://<cosmos_url>/media/product/<base_image>/<base_image>-<dimension><resolution>.<format>
- https://<cosmos_url>/dyn/product/<base_image>/size:<width>:<height>:<enlarge=false>/<base_name>.<format>
- https://<cosmos_url>/dyn/product/<base_image>/preset:<small|medium|large>/<base_name>.<format>?etag=<etag>
Supported image file formats include jpg, png, webp, eps, avif and gif.
Example Requests
- https://<cosmos_url>/media/product/10844/10844-w648.jpg
- - Returns the 10844 base image in jpg file format with a scaled width based resolution of 648 pixels
- https://<cosmos_url>/media/product/10844/10844-h378.jpg
- - Returns the 10844 base image in jpg file format with a scaled height based resolution of 378 pixels
- https://<cosmos_url>/dyn/product/04004/size:648::/04004.jpg?etag=12345
- - Returns the 04004 base image in jpg format with in a width of 648 pixels and jpg file format
- https://<cosmos_url>/dyn/product/04004/preset:small/04004.jpg?etag=12345
- - Returns the 04004 base image in preset size of small