Зображення: зміна розміру, обрізання й формат¶
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, чорні поля зліва й справа |
- Зміна розміру не збільшує зображення понад оригінал. Якщо заданий розмір більший, ви отримаєте зображення в розмірі оригіналу.
- Обрізання й поля можуть збільшити зображення понад оригінал. Вибирайте розмір, не більший за оригінальне зображення, інакше якість погіршиться.
Зміна формату¶
Додайте 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 · Повідомити про проблему на цій сторінці