In many API responses, a thumbnail_url is returned. The size can be controlled with the thumb_width
and thumb_height
request parameters,
but further customization is possible.
NOTE: It's OK to cache the thumbnail URL, but always use the API to retrieve the thumbnail URL as it may change over time. Periodic revalidation of asset publishing status is required, during which you should refresh the thumbnail URL. Do not store it as a canonical reference to the asset.
w
or h
for resizing by one dimension while preserving aspect ratio.x
for resizing and cropping to exact dimensions.{cx}-{cy}
._q
to control JPEG quality (ignored for WebP).Format | Description | Example URL |
---|---|---|
500h_q95.jpg |
Resize to 500px tall; width is auto-scaled. | Link |
500x400_q95.jpg |
Resize and crop to exactly 500×400px. | Link |
500x400_50-50_q95.jpg |
Resize and crop to 500×400px, with crop centered at 50% left / 50% top of the source. | Link |
500x400
), a crop is performed.{cx}-{cy}
, where:
cx
= percentage from the left edge (0–100).cy
= percentage from the top edge (0–100).50-0
(center horizontally, top vertically).50-50
(center both horizontally and vertically).50-50
→ Centered in the middle of the image50-0
→ Centered horizontally, aligned at the top50-40
→ Centered horizontally, 40% down from the top30-70
→ 30% from left, 70% down from the topThis allows precise control over which part of the image is visible after cropping.
_q{value}
specifies the JPEG quality (1–100)._q95
= 95% JPEG quality.