Media
Змінити розмір зображення
Змініть розмір зображення до розмірів соцмереж, додайте водяні знаки або обріжте
POST
Соціальні мережі мають специфічні вимоги до зображень. Ендпоінт resize дозволяє вибрати сумісний із соцмережею розмір зображення, додати водяні знаки, змінити фон, додати ефекти, обрізати тощо.
За замовчуванням зміна розміру змінює розміри зображення, але не обрізає його. Ви можете натомість обрізати зображення. Деталі див. нижче.
Ви також можете вказати власні розміри через поле
Має бути вказано або
Ви також можете вказати власні розміри та необов’язкові координати обрізання через поле
Має бути вказано або
Приклад розмитого зображення:

Приклад зображення з водяним знаком у позиції southeast:

Приклад зображення з кольоровим фоном:

Приклад зображення grayscale:

Приклад конвертації в WebP:
Параметри заголовка
Параметри тіла запиту
URL зображення, розмір якого потрібно змінити. Має починатися з
https://Платформа соцмережі, для якої буде змінено розмір за URL. Деталі див. у розділі опції платформ.
Надішліть медіафайл як multipart form-data. Обов’язковий, якщо не надано
imageUrl.URL і необов’язкове положення водяного знака, який застосовується до зображення зі зміненим розміром. За замовчуванням водяний знак з’являється
в нижньому правому куті зображення. Деталі див. у розділі watermark.
Зміна прозорості, кольорів тощо. Деталі див. у розділі опції ефектів.
Об’єкт, що вказує
width і height для зміни розміру. При обрізанні можна додатково вказати координати центру x і y.
Типово — це центр зображення.Dimensions
Ширина й висота обов’язкові, якщо платформа не вказана.
Автоматично конвертувати у файл JPG, наприклад з PNG у JPG. Використовуватиметься якість 75%.
Деталі див. у розділі convert to a JPG.
Автоматично конвертувати у файл WebP, наприклад з PNG у WebP. Використовуватиметься якість 75%.
Деталі див. у розділі convert to a WebP.
Опції платформ
Укажіть платформу як рядок, щоб використати попередньо визначені розміри зображення, або задайте власні через полеdimensions.
Наприклад, "platform": "facebook" задасть розміри зображення 1200px по ширині та 630px по висоті.
facebook: ширина 1200px, висота 630px.instagram: ширина 1080px, висота 1080px.instagram_landscape: ширина 1080px, висота 680px.instagram_portrait: ширина 1080px, висота 1920px.instagram_special: ширина 1080px, висота 800px.linkedin: ширина 1200px, висота 627px.pinterest: ширина 1080px, висота 1920px.tiktok: ширина 1080px, висота 1920px.twitter: ширина 1600px, висота 900px.
mode зі значенням crop разом із полями dimensions, xCoordinate та yCoordinate.
Mode
Resize
Resize — типовий режим, який змінює розміри зображення зі збереженням його пропорцій. Змінити розмір зображення до вказаних розмірів без обрізання будь-якого вмісту. Приклад JSON:Resize
dimensions:
Resize with Dimensions
platform, або поля width та height у dimensions.
Crop
Crop «обріже» зображення до вказаних розмірів. За замовчуванням центральною координатою є центр зображення. Ви можете вказати власні координати x/y. Приклад JSON:Crop
dimensions:
Crop with Dimensions
platform, або поля width та height у dimensions.
Для квадратних обрізань, якщо width або height менше розмірів наданого зображення, буде використано менше з width або height. Наприклад, якщо зображення 1200x800, а запит на обрізання — 1080x1080, повернене зображення буде 800x800.
Blur
Ефект розмиття дублює зображення як фон і розмиває його. Приклад JSON для blur:Blur

Watermark
Огляд водяного знака
Ви можете додати водяний знак до зображення, вказавши URL, який має починатися зhttps://, та необов’язкове положення.
За замовчуванням водяний знак з’являється в нижньому правому куті зображення — southeast.
Рекомендуємо використовувати PNG із прозорим фоном.
Приклад JSON для watermark:
Watermark

Положення водяного знака
Положення водяного знака може бути одним із наступних:northnortheasteastsoutheastsouthsouthwestwestnorthwestcenter
Опції ефектів
Шістнадцятковий колір
Шістнадцяткове значення кольору фону для blur. Застосовується лише якщо"mode": "blur". Значення рядкове, наприклад "#A020F0"
Приклад JSON із кольоровим фоном:
Color Background

Колір: Grayscale, Sepia, Invert
Ви можете змінити основний колір зображення, вказавшиgrayscale, sepia або invert. Поле "blur": true не потрібне і не повинно використовуватися, якщо фон не потрібен.
Приклад JSON grayscale:
Grayscale

Прозорість
Установіть прозорість зображення. Діапазон числового значення: 0 – 1. Приклад JSON opacity:Opacity
Якість
Для зображень JPG або JPEG вкажіть якість або ступінь стиснення зображення. Чим менше число, тим більше стиснення, але нижча якість зображення. Чим більше число, тим менше стиснення, але вища якість зображення. Діапазон числового значення: 0 – 100. Приклад JSON quality:Quality
Конвертація в JPG або WebP
ОпціїconvertToJpg і convertToWebP дозволяють перетворити зображення з їхнього початкового формату (наприклад, PNG) на формат JPG або WebP відповідно.
За замовчуванням конвертовані зображення матимуть налаштування якості 75%.
Ви можете налаштувати рівень стиснення за допомогою параметра quality у об’єкті effects.
Зверніть увагу: якщо ваше джерело вже є JPG і ви використовуєте convertToJpg, API просто змінить розмір зображення до вказаних розмірів без зміни формату.
Приклад конвертації в JPG:
Convert to JPG
Convert to WebP
