Download/serve an object
GET/v1/storage/{project_id}/{bucket}/{key}
Serves the bytes of an object. Image transformations are requested as query parameters and their result is cached by unique combination.
Query params#
| Parameter | Type | Required | Description |
|---|---|---|---|
width | integer | no | Target width in pixels (images only). |
height | integer | no | Target height in pixels. |
fit | enum | no | contain (default) · cover · fill. |
format | enum | no | jpeg · png · webp · gif. There is neither autonor avif: without this parameter, the original format is preserved. |
quality | integer | no | 1-100, bounded on the server side. Applied to JPEG encoding only — PNG and GIF are lossless and ignore it. |
rotate | integer | no | Rotation in degrees. |
flip_h / flip_v | boolean | no | Horizontal/vertical mirror. |
expires + sig | string | no | Pair produced by signed URL generation. Only way to read a private object without project identity. |
Access control#
Attention
There is no public segment in the URL: the same path serves public and private objects, and it is the bucket that decides. A private object is only served with a valid signed URL, an authenticated project identity, or to the owner of the object; an anonymous request to an unknown bucket is refused (fail-closed).
Derivatives cache#
Tip
Each combination of parameters produces a separate derivative key, stored under a reserved prefix: the transformation is calculated only once. ?width=300 and ?width=240 are two independent derivatives.
Last updated · Apr 15, 2026↗ Edit on GitHub↗ Report a problem