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

Параметри заголовка

Параметри тіла запиту

imageUrl
string
обов'язково
URL зображення, розмір якого потрібно змінити. Має починатися з https://
platform
array
обов'язково
Платформа соцмережі, для якої буде змінено розмір за URL. Деталі див. у розділі опції платформ.
file
object
Надішліть медіафайл як multipart form-data. Обов’язковий, якщо не надано imageUrl.
watermark
object
URL і необов’язкове положення водяного знака, який застосовується до зображення зі зміненим розміром. За замовчуванням водяний знак з’являється в нижньому правому куті зображення. Деталі див. у розділі watermark.
effects
string
Зміна прозорості, кольорів тощо. Деталі див. у розділі опції ефектів.
dimensions
object
Об’єкт, що вказує width і height для зміни розміру. При обрізанні можна додатково вказати координати центру x і y. Типово — це центр зображення.
Dimensions
Ширина й висота обов’язкові, якщо платформа не вказана.
mode
string
за замовчуванням:"resize"
Значення: resize, blur або crop. Деталі див. у розділі mode.
convertToJpg
boolean
Автоматично конвертувати у файл JPG, наприклад з PNG у JPG. Використовуватиметься якість 75%. Деталі див. у розділі convert to a JPG.
convertToWebP
boolean
Автоматично конвертувати у файл 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
Приклад зображення з водяним знаком у позиції southeast: Додати водяний знак

Положення водяного знака

Положення водяного знака може бути одним із наступних:
  • north
  • northeast
  • east
  • southeast
  • south
  • southwest
  • west
  • northwest
  • center

Опції ефектів

Шістнадцятковий колір

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

Колір: Grayscale, Sepia, Invert

Ви можете змінити основний колір зображення, вказавши grayscale, sepia або invert. Поле "blur": true не потрібне і не повинно використовуватися, якщо фон не потрібен. Приклад JSON grayscale:
Grayscale
Приклад зображення 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
Приклад конвертації в WebP:
Convert to WebP