Загрузка изображений

Изображения, добавленные через редактор SUPA, уже загружены на сервер и загружать их повторно нет необходимости. Однако вам может понадобиться программно заменять изображения в ролике. Например, изменять фотографию товара в каждом видео.

Для того чтобы использовать в ролике дополнительные изображения, вам необходимо сначала загрузить их на наш сервер.

Если размер изображения хотя бы по одной из сторон превышает 1600 пикселей, оно будет пропорционально сжато до этого значения.

Максимальный размер файла - 10 МБ.

Изображения загружаются во временное хранилище и доступны в течение 30 дней, после этого будут удалены. Пожалуйста, учитывайте это при разработке.


Для загрузки изображения на сервер можно использовать следующий метод:

POST https://uploader.supa.ru/upload?api_key=YOUR_API_KEY&v=1.0

В параметре image вы передаете файл как multipart/form-data.

Ответ

{
    "message": "success",
    "image_url": "https://supa-uploads.storage.yandexcloud.net/7214/api/yzkrryvoigqs.png"
}

Коды ответа

Код Сообщение Описание
200 - Успешно. Изображение загружено. Ответ включает в себя image_url, который можно использовать в ролике
400 incorrect_data Некорректный файл
400 limit_file_size Большой размер файла
403 api_key_incorrect Неправильный API-ключ
5xx - Ошибка сервера