Документация к плагину "ChatGPT: генерация контента для товаров"

Инструкция по получению API-ключа

При создании нового аккаунта на платформе OpenAI (ChatGPT) вам предоставляется стартовый бесплатный баланс в размере 5$, который можно использовать для тестирования API в течение 3-х месяцев (информация актуальна на 25.01.2025). Рекомендую попробовать использовать именно ChatGPT.

ChatGPT

Регистрация на официальном сайте OpenAI (ChatGPT) и получение API-ключа:

Создайте новую электронную почту на Gmail, если у вас её ещё нет. Это важно, так как почта на "Яндексе", "Mail.ru" и других сервисах российских компаний может не подойти для регистрации на платформе OpenAI.
Если ваш IP-адрес — российский, то сайт компании OpenAI будет блокировать вас. Использование VPN в браузере решает эту проблему.
Зайдите на сайт https://platform.openai.com/signup/.
Если у вас ещё нет аккаунта, зарегистрируйтесь, указав свою почту и придумав пароль (рекомендую использовать опцию "Продолжить с Google"). На этом этапе, надеюсь, вы разберетесь сами как создать аккаунт.
После успешного входа в аккаунт, вы попадёте на главную страницу OpenAI API.
Наведите курсор на своё имя или аватар в правом верхнем углу экрана и нажмите на пункт “Manage account” (Управление аккаунтом).
В открывшемся меню выберите вкладку “API keys”.
На странице управления API-ключами найдите кнопку “Create new secret key” и нажмите на неё.
Система сгенерирует новый API-ключ. Скопируйте этот ключ, так как после закрытия окна вы больше не сможете его увидеть.
Теперь вы можете использовать этот ключ для интеграции с ChatGPT API.

Как узнать, какие модели доступны на вашем аккаунте OpenAI:

Перейдите на сайт platform.openai.com и войдите в свой аккаунт.
Перейдите в раздел "API" в меню управления.
Откройте вкладку "Models" (Модели), где будет указан список всех доступных моделей для вашего аккаунта.
Проверьте, какие модели отображаются в списке. Это будут доступные для вашего аккаунта версии, такие как GPT-3.5, GPT-4 и другие.
Если нужная модель не отображается, перейдите в раздел "Usage" (Использование) для проверки лимитов и тарифного плана, так как доступ к некоторым моделям может зависеть от выбранного тарифа.
Если вы не можете найти нужную модель, обратитесь в поддержку OpenAI через раздел "Help" для получения точной информации о доступности моделей для вашего аккаунта.

Как пополнять баланс на аккаунте OpenAI самостоятельно:

Перед тем как пополнить баланс в личном кабинете OpenAI, убедитесь, что по полученному ранее API-ключу плагин работает. Проверьте соединение, используя функционал плагина (см. вкладку Инструкция по настройке плагина (Настройки API) данной документации).
Компания OpenAI может блокировать российские IP-адреса.
- использование VPN в браузере может решить проблему;
- если вы не хотите или не можете использовать VPN в браузере, то рассмотрите возможность использования других нейронных сетей (например, китайских Qwen или DeepSeek или российского «GigaChat»);
- в крайнем случае воспользуйтесь платформой CognitiveAI — она позволяет работать с ChatGPT с оплатой в рублях.
Инструкции по подключению к Qwen, DeepSeek и CognitiveAI доступны в отдельных вкладках.
Если в настройках плагина соединение успешно проверено, вернитесь в личный кабинет OpenAI на сайте platform.openai.com, авторизуйтесь.
Откройте вкладку “Billing” (Платежи) в меню аккаунта.
Нажмите на кнопку “Add funds” (Добавить средства).
Выберите подходящую сумму для пополнения и удобный способ оплаты (например, банковская карта; учтите, что карты российских банков не подойдут).
Заполните данные для оплаты и подтвердите платёж, перед этим убедившись, что ваша карта поддерживает международные платежи.
После успешной оплаты проверьте баланс аккаунта. Пополненная сумма должна быть отображена в разделе “Usage” (Использование).
Теперь вы можете использовать средства для работы с API OpenAI. Учтите, что средства списываются на основе фактического объёма запросов к API.

Как пополнять баланс на аккаунте OpenAI, если нет карты иностранного банка? Варианты:

Друзья/знакомые с банковской картой иностранного банка — самый рекомендуемый способ.
Оплата через посредников — некоторые сервисы предлагают услуги пополнения баланса OpenAI за комиссию (поищите их самостоятельно).
Оплата через посредников — некоторые сервисы предлагают услуги пополнения баланса OpenAI за комиссию (поищите их самостоятельно).
Можно не пополнять баланс, а просто переподключиться к VPN, создать новый аккаунт с новой электронной почтой и заново получить 5$ на баланс (информация актуальна на 25.01.2025).

DeepSeek

Регистрация на официальном сайте «DeepSeek» и получение API-ключа:

Зайдите на сайт https://platform.deepseek.com/sign_in.
Если у вас ещё нет аккаунта, зарегистрируйтесь, указав свою почту и придумав пароль или воспользуйтесь функцией"Log in with Google" (Перед этим создайте новую электронную почту на Gmail, если у вас её ещё нет).
После успешной авторизации перейдите во вкладку "API Keys" (https://platform.deepseek.com/api_keys) и нажмите на кнопку "Create new API key".
Придумайте любое название API-ключа и нажмите кнопку кнопку "Create API key", после чего скопируйте сгенерированный API-ключ. Готово! Пополните баланс и начинайте работать.

Qwen

Регистрация на официальном сайте Alibaba Group (Qwen) и получение API-ключа:

Зайдите на сайт https://bailian.console.alibabacloud.com/.
Если у вас ещё нет аккаунта, зарегистрируйтесь, указав свою почту и придумав пароль; либо авторизуйтесь через аккаунт Google (если у вас его нет, то предварительно создайте новую электронную почту на Gmail).
После успешной регистрации войдите в свой аккаунт, используя созданные учетные данные.
В личном кабинете наведите курсор на изображение профиля в правом верхнем углу страницы и выберите API-KEY.
Далее выберите All API Keys или My API Key и создайте API-ключ.

Если предоставленной в инструкции информации недостаточно, см. подробнее инструкцию на официальном сайте https://www.alibabacloud.com/help/en/model-studio/developer-reference/get-api-key.

CognitiveAI

Что такое CognitiveAI?

CognitiveAI — это не самостоятельная нейронная сеть, как ChatGPT, YandexGPT или GigaChat, а платформа, которая позволяет интегрироваться с различными нейронными сетями. Рекомендуется использовать данную платформу, если вы хотите работать с ChatGPT, но у вас нет возможности использовать VPN или пополнять баланс напрямую в ChatGPT.

Как создать аккаунт и начать пользоваться:

Перейдите на сайт https://lk.cognitiveai.ru/ и зарегистрируйтесь, указав свою электронную почту.
После регистрации в разделе «API» сгенерируйте новый токен и сохраните его в безопасном месте.
На вашем аккаунте должно быть автоматически начислено 10 руб. (актуально на 25.01.2025). Используйте эти средства, чтобы протестировать соединение в настройках плагина (см. вкладку Инструкция по настройке плагина (Настройки API) данной документации).
Ознакомьтесь с доступными тарифами CognitiveAI. Если вам требуется небольшой объём текстов, пополните баланс и начните пользоваться платформой. Для больших объёмов работы выгоднее оформить подписку в разделе «Платная подписка» за 600 руб./мес. В рамках подписки вы сможете подключить свой API-ключ от ChatGPT (см. вкладку Инструкция по получению API-ключа → ChatGPT данной документации) и использовать его на платформе CognitiveAI, что значительно снизит стоимость токенов.

GigaChat

Для физ лиц:

Зайдите на сайт https://developers.sber.ru/docs/ru/gigachat/quickstart/ind-create-project и следуйте инструкции по регистрации в личном кабинете. Потребуется авторизация по Сбер ID (иначе доступа к API «GigaChat» не будет).
В личном кабинете получите Authorization key. Именно его нужно будет указать в настройках плагина. Значения Client ID и Client Secret, которые также можно увидеть в личном кабинете «GigaChat», не потребуются.

Для ИП и юр лиц:

Индивидуальные предприниматели и юридические лица могут использовать GigaChat API только после оплаты. Перед тем как сразу интегрироваться с «GigaChat» в качестве ИП или юр лица, рекомендую потестировать работу в качестве физ лица, т.к. это можно сделать бесплатно и без заключения договоров. Возмонжо, качество ответов «GigaChat» вас не устроит и вы захотите использовать другую нейросеть.

Зайдите на сайт https://developers.sber.ru/docs/ru/gigachat/quickstart/legal-tokens-purchase и следуйте инструкции по регистрации в личном кабинете.
В личном кабинете получите Authorization key. Именно его нужно будет указать в настройках плагина. Значения Client ID и Client Secret, которые также можно увидеть в личном кабинете «GigaChat», не потребуются.

Инструкция по настройке плагина (Настройки API)

Установите плагин.
Перейдите в настройки плагина (Магазин --> Плагины --> Плагин "ИИ (ChatGPT, DeepSeek, Qwen, GigaChat): генерация контента для товаров").
Во вкладке Настройки API выберите сервис, с которым планируете работать, модель ИИ, укажите API-ключ. Если вы используете «GigaChat», то вместо API-ключа укажите Authorization key и выберите версию API, в зависимости от типа вашего аккаунта в Сбере.
Проверьте соедение Продолжайте дальнейшую работу с плагином, только если при проверке соедения получили сообщение вида: "Успешное соедение". Если вы получили сообщение об ошибке — устраняйте ее.
Плагин готов к работе!

Инструкция по работе с плагином (Отправка запросов к ИИ)

Перейдите во вкладку Отправка запросов к ИИ.
В настройке Тип генерируемого контента выберите, что вы будете генерировать:
В настройке Шаблон промпта укажите промпт, используя синтаксис Smarty. Пример:
В шаблоне рекомендуется использовать массив {$product}. Примеры использования:
- {$product.name} — название товара
- {$product.common_features_string} — список характеристик товара и их значений
- {$product.sku_features_string} — список характеристик артикулов товара и их значений
- {$product|wa_dump} — дамп массива $product (чтобы посмотреть полный список доступных переменных в массиве)
Вы можете использовать готовые шаблоны промптов, разработанные и применяемые нами на рабочих проектах.
После копирования рекомендуем протестировать работу промпта на 10–20 товарах. Это поможет выявить возможности для его улучшения и адаптировать под особенности вашей тематики и ассортимента товаров.
В настройке ID характеристик, исключаемых из $product в промптах укажите ID характеристик через зяпятую, которые не должны выводиться в переменных и (если вы их используете в шаблонах промптах).
В настройке Список товаров для генерации выберите список товаров, предварительно создав его и добавив в него нужные товары. Плагин не позволяет выбрать динамические списки. Плагин не предоставляет функционал для поиска товаров и добавления их в список. Используйте для этого штатный функционал Shop Script, либо плагины других разработчиков (например, для удобной работы со списками товаров рекомендуем использовать функционал нового интерфейса Shop Script — UI 2.0, либо плагин Фильтр и поиск товаров в бекенде и в дополнение к нему — Исключение группы товаров из списков).
Нажмите кнопку Сохранить настройки плагина и сгенерировать промпты для товаров из списка. Если у вас в списке >1000 товаров и/или в магазине >1000 характеристик — ожидайте несколько секунд. При возникновении ошибки «Ошибка в экшене promts» — проверьте ваш шаблон промптов, скорее всего вы там допустили синтаксическую ошибку. Если не можете поправить самостоятельно — обратитесь за помощью к специалистам, либо к нейросети.
Если ошибок в шаблоне промптов нет, то откроется окно с товарными позициями и сгенерированными по шаблону промптами. Проверьте их корректность, и когда будете готовы — запускайте генерацию.
Не закрывайте окно браузера, пока процесс генерации не завершится. Если что-то пойдет не так и генерация прервется — не переживайте, ее можно будет возобновить в любой момент. Если у вас большой объем — можно оставить браузер включенным и поставить генерацию контента на ночь.
Если в процессе генерации вы увидите что получаемые результаты не соответствуют вашим ожиданиям — прервите генерацию, чтобы зря не расходовать бюджет. Затем удалите полученные некачественные результаты, улучшайте шаблон промпта, и пробуйте снова. Пробуйте разные нейросети, разные модели. Надеюсь, разберетесь :)

Инструкция по работе с плагином (Обработка ответов от ИИ)

Перейдите во вкладку Обработка ответов от ИИ.
В настройке Тип сгенерированного контента выберите тот тип, для которого вы сгенерировали контент.
Нажмите кнопку Отобразить неопубликованный сгенерированный контент выбранного типа.
Откроется окно с товарными позициями и сгенерированным ИИ-контентом. Обязательно проверьте корректность каждого сгенерированного текста. По необходимости отредактируйте тексты. При работе с описаниями товаров или с краткими описаниями товаров, не забывайте использовать html-разметку. Если результатов, требующих корректировки, слишком много — это повод задуматься о том, что промпт составлен неудачно. В таком случае рекомендуется удалить все тексты, скорректировать промпт и начать процесс заново — это будет быстрее и дешевле, чем редактировать большое количество текстов.
Когда проверите все тексты, выберите нужные товары. Для выбора всех товаров можно использовать галочку в левом верхнем углу таблицы. Также есть возможность выбора нескольких товаров с зажатой клавишей Shift или.
Выберите куда нужно сохранять результаты (по умолчанию, подставляется значение в зависимости от выбранного типа контента при генерации), и затем нажмите кнопку Опубликовать. Мы рекомендуем публиковать все данные, полученные от нейросети, в дополнительные параметры товара. Это позволит избежать путаницы между описаниями, написанными человеком, и сгенерированными ИИ. Помните, что в ID дополнительных параметров можно использовать только латинские символы, цифры и символ нижнего подчеркивания. Плагин не дает вводить здесь прочие символы. Не забудьте сменить раскладку на английский язык.
Проверьте, корректно ли сохранились данные, перейдя в настройки одного из товаров (Магазин → Товары → *ваш товар* → кнопка «Редактировать» → вкладка «Описание и SEO»).
Готово!

Техническая поддержка

Техническая поддержка осуществляется только через личный кабинет. Инструкция по созданию заявки здесь. Пожалуйста, не пишите по вопросам ТП плагинов на электронную почту и в мессенджеры.
Техническая поддержка обычно осуществляется: Пн-Вс 08:00-20:00 (мск).
Среднее время реакции на обращения: 2 часа 23 минуты (я замерял).
Максимальное время реакции на обращения: 2-3 рабочих дня