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.
This English text was generated automatically from the French original and has not been reviewed yet.
#
Request
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. |
#
Notes
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).
#
Notes
Derivatives cache
Astuce
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.
v1.0 · revised Apr 15, 2026