Фото в карточки Wildberries через API

Зачем загружать фото через Solistra

Обновить фото в одной карточке можно и в кабинете продавца. Сложности начинаются, когда новых фото десятки или сотни: нужно разложить файлы по артикулам, сохранить порядок, не потерять главное фото и потом проверить, что всё встало как надо.

Solistra делает это в одном окне. Серия из Фотостудии или результаты генерации уходят прямо в карточки Wildberries, а сервис показывает статус по каждой карточке и хранит прежний набор фото.

Как подключить кабинет Wildberries

Solistra подключается к кабинету через токен WB API. Справка Wildberries рекомендует заводить отдельный токен под каждую интеграцию, так проще управлять доступами и отключать их.

• В кабинете продавца откройте раздел «Интеграции по API» и нажмите «Создать токен»
• На вкладке «Для интеграции вручную» выберите базовый токен
• Отметьте категорию данных «Контент» и уровень доступа «чтение и запись»
• Скопируйте токен сразу, второй раз Wildberries его не покажет
• В Solistra откройте «Карточки», добавьте кабинет, вставьте токен и нажмите «Проверить»

Почему достаточно категории «Контент»

Категория «Контент» в WB API отвечает за карточки товаров, в том числе за загрузку и замену фото. Права на цены и скидки, аналитику, финансы, поставки и заказы Solistra не нужны, их можно не отмечать.

Если токен выдан только на чтение, Solistra покажет понятную ошибку при первой попытке записи и не будет пробовать отправлять фото. Токен WB действует 180 дней. Когда срок подходит к концу, создайте новый кнопкой «Дублировать» в кабинете и замените ключ в Solistra.

Поиск карточки по артикулу и nmID

Карточку можно найти по артикулу продавца или по артикулу WB, он же nmID. Solistra показывает текущие фото карточки и рядом набор, который получится после отправки, поэтому ошибку видно до записи.

Фото для отправки берутся из серии Фотостудии, результатов генерации или ваших загрузок. Первое фото становится главным, порядок меняется перетаскиванием.

Три режима замены

Wildberries принимает итоговый список фото карточки целиком, а порядок в списке становится порядком фото на витрине. Solistra сначала читает текущий набор, собирает из него новый список по выбранному режиму и отправляет площадке полный итоговый набор.

• Заменить все · старые фото уходят, на их месте ваша новая серия
• Добавить в конец · текущие фото остаются, новые встают после них
• Заменить только главное · меняется первое фото, остальные остаются на местах

Пакет, статус и откат

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

Перед записью Solistra сохраняет прежний набор фото в истории, а после записи читает карточку обратно и сравнивает с тем, что отправлял. Успех показывается только после такой проверки. Если новая серия не понравилась, прежние фото возвращаются из журнала одной кнопкой.

Безопасность ключа

Токен хранится зашифрованным на сервере в России и не попадает в браузер, логи и ответы API. Запросы к Wildberries идут из России напрямую. Отключение кабинета в Solistra удаляет ключ, а сам токен вы можете в любой момент удалить в кабинете продавца.

Solistra работает только с фото карточек. Цены, остатки, описания, характеристики и заказы Solistra не меняет.

Через файл выгрузки без ключей

Если токен давать не хочется, загрузите в Solistra выгрузку карточек Wildberries. Сервис сопоставит ваши фото с артикулами по имени файла или по вашему выбору и выдаст архив, где каждое фото названо по артикулу и номеру, а также отчёт проверки.

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

Требования Wildberries к фото

Справка Wildberries для продавцов на август 2026 года требует форматы JPG, PNG или WEBP, разрешение от 700 × 900 пикселей, качество сжатия от 65% и файл до 10 МБ. В карточке может быть до 30 фото. Перед загрузкой сверьте требования с актуальной версией справки.

По визуальным правилам товар на главном фото виден целиком, фон нейтральный, вся серия снята в одном стиле, а маркетинговые надписи и слишком яркая инфографика на главном фото могут снизить рейтинг карточки. Неестественные фото нейросети с искажённым текстом справка тоже относит к ошибкам.