Изображения: изменение размера, обрезка и формат¶
URL изображений из XML-фида и Content API ведут на CDN изображений MEGOGO
(*.vcdn.biz). CDN умеет менять размер изображения, обрезать его,
добавлять поля и менять формат файла. С помощью этих операций можно
получить изображение ровно того размера, который нужен вашему экрану, —
и приложению не придется загружать большие файлы.
Формат URL¶
Добавьте операцию в конец URL изображения:
{image_url}/pt/{operation}{width}x{height}
{image_url}/pt/{operation}{width}x{height}x{format}
| Часть | Значение |
|---|---|
{image_url} |
URL изображения из XML-фида или из Content API, например https://s4.vcdn.biz/static/f/11995104541/image.jpg |
{operation} |
r (изменение размера), c (обрезка) или p (поля). См. Операции |
{width}x{height} |
Размер в пикселях. Подойдет любой размер, см. Размеры. 0 означает, что значение нужно вычислить по пропорциям изображения |
{format} |
Необязательная часть. Формат итогового файла: 1 JPEG, 2 GIF, 3 PNG, 4 WebP, 5 AVIF. См. Изменение формата |
Пример:
https://s4.vcdn.biz/static/f/11995104541/image.jpg/pt/r155x220
ВНИМАНИЕ
Между числами ставьте латинскую букву x. В некоторых ключах Content
API (image_470х270) стоит кириллическая х. Если скопировать ее в
URL, CDN не обработает изображение и вернет оригинал.
Операции¶
| Операция | Код | Результат | Пример | Результат для оригинала 2 500 × 3 525 px |
|---|---|---|---|---|
| Изменение размера | r |
Изображение вписывается в заданный размер с сохранением пропорций. Одна сторона совпадает с заданной, другая меньше или равна ей | /pt/r260x260 |
184 × 260 |
| Обрезка | c |
Изображение заполняет весь заданный размер, а то, что не поместилось, CDN обрезает. Если пропорции совпадают, CDN только меняет размер | /pt/c260x260 |
260 × 260 |
| Поля | p |
Изображение вписывается в заданный размер с сохранением пропорций, а свободное место CDN заполняет черными полями | /pt/p260x260 |
260 × 260, черные поля слева и справа |
- Операция
rне увеличивает изображение: если заданный размер больше оригинала, вы получите изображение в исходном размере. - Операции
cиpмогут увеличить изображение. Выбирайте размер не больше исходного, иначе качество ухудшится.
Изменение формата¶
Добавьте x{format} после размера:
| Код | Формат | Пример |
|---|---|---|
1 |
JPEG | /pt/r193x272x1 |
2 |
GIF | /pt/r193x272x2 |
3 |
PNG | /pt/r193x272x3 |
4 |
WebP | /pt/r193x272x4 |
5 |
AVIF | /pt/r193x272x5 |
Чтобы изменить только формат, а размер оставить исходным, укажите 0x0
или размер оригинала: /pt/c0x0x4 вернет исходное изображение в WebP.
Рекомендуем WebP или AVIF: при том же размере изображения такие файлы легче, чем JPEG. Прежде чем переходить на AVIF, убедитесь, что его поддерживают все ваши платформы.
Размеры¶
Подойдет любой размер. Ниже перечислены размеры, которые использует MEGOGO:
| Тип | Размеры (ширина × высота, px) |
|---|---|
| Вертикальные | 40x56, 70x100, 90x128, 115x200, 130x187, 130x2000, 140x200, 148x210, 155x220, 160x225, 162x2000, 170x240, 172x248, 180x256, 193x272, 193x278, 208x290, 220x318, 236x338, 260x374, 260x375, 282x414, 300x423, 330x460, 350x500, 352x450, 370x520, 382x540, 386x544, 540x2000, 668x1000, 700x1000, 772x1088 |
| Горизонтальные | 88x65, 100x56, 105x60, 105x85, 125x70, 126x71, 130x70, 136x86, 150x85, 155x87, 162x100, 172x96, 193x110, 200x112, 215x120, 220x100, 220x125, 230x130, 236x107, 236x132, 260x140, 264x150, 272x172, 300x168, 300x170, 300x200, 300x253, 310x174, 352x200, 426x270, 440x200, 460x342, 462x270, 470x270, 480x330, 492x284, 600x336, 600x340, 600x506, 640x360, 646x210, 675x255, 900x340, 920x684, 935x525, 980x560, 1080x340, 1200x68, 1280x720, 1350x510, 1600x520, 1620x540, 1920x1080 |
| Квадратные | 40x40, 50x50, 60x60, 70x70, 80x80, 88x88, 93x93, 100x100, 105x105, 120x120, 140x140, 150x150, 170x170, 180x180, 225x225, 230x230, 260x260, 300x300, 345x345, 370x370 |
| Только ширина (высота зависит от изображения) | 136x0, 272x0, 300x0, 375x0, 460x0, 600x0, 750x0, 920x0, 1600x0, 3200x0 |
| Только высота (ширина зависит от изображения) | 0x110, 0x132, 0x170, 0x180, 0x284, 0x340, 0x360, 0x680 |
Для вертикального постера (соотношение сторон примерно 1 : 1,41)
выбирайте вертикальный размер с тем же соотношением, например 193x272
или 300x423, и операцию r. Для горизонтального изображения (16 : 9)
подойдут, например, 640x360 или 1280x720.
Кеш¶
CDN кеширует каждый результат: в ответе приходит
Cache-Control: max-age=31536000 (один год). Запрашивайте одно и то же
изображение одного размера по одному и тому же URL — тогда оно будет
отдаваться из кеша.
Версия руководства 1.4.1, 2026-10-31 · Сообщить о проблеме на этой странице