Запрос к DALL·E OpenAI
Запрос к DALL·E Open AI отправляет текстовое описание в нейросеть DALL·E и присылает одну или несколько ссылок на изображения, которые были сгенерированны по этому описанию.
Все шаги по подключению DALL·E можно посмотреть в этом видео:
- Настройка компонента →
- Как вывести изображение из DALL·E в сообщение →
- Как принимать запросы от пользователей →
- Видеоурок по подключению DALL·E OpenAI в бота →
Настройка компонента
1. Из раздела Компоненты на правой панели перетащите или добавьте двойным щелчком мыши компонент Запрос к DALL·E OpenAI на нужный экран.
2. В поле Ключ доступа добавьте токен OpenAI. Его можно получить в личном кабинете OpenAI (LogIn — API). Затем в разделе Overview откройте вкладку Personal и выберите в ней раздел View API keys.
Если OpenAI не доступен в вашей стране, воспользуйтесь VPN-сервисом.
Сгенерируйте токен с помощью кнопки Create new secret key.
3. В поле Текст запроса впишите описание картинки, которую должна сгенерировать нейросеть.
Описание может быть написано обычным текстом или взято из переменной.
Чем проще будет описание, тем быстрее сгененируется изображение.
4. Добавьте Имя переменной для ответа, для того, чтобы ссылка на изображение из DALL·E передалась в эту переменную.
После того, как картинка сгенерируется и попадет в бот, ее можно будет вывести.
5. Укажите Экран успешного запроса. Этот экран выполнится при успешном запросе к нейросети. Если экран успешного запроса не будет выбран, то в случае успеха, выполнится следующий компонент.
6. Укажите Экран ошибки запроса. Этот экран выполнится в случае одной или нескольких ошибок запроса. Примеры ошибок:
- картинка генерируется слишком долго;
- указан неверный токен OpenAI;
- OpenAI недоступен;
- oшибка на стороне OpenAI.
Ответы ожидаются в течении 30 секунд, затем приходит ошибка по таймауту. Изменить время ожидания можно через поддержку
7. В Продвинутых настройках выберите из списка модель, которая будет генерировать картинки.
8. При использовании модели DALL·E - 2 укажите сколько изображений нужно сгенерировать. Если вы выбрали DALL·E - 3, то поле с выбором числа изображений не отобразится в настройках компонента, так как DALL·E - 3 может сгенерировать только одно изображение.
9. Если выбрана модель DALL·E - 2, поменяйте или оставьте по умолчанию размер, который должен быть у изображений. При выборе модели DALL·E, изображения будут генерироваться в одном размере, поменять его не получится.
Как вывести изображение из DALL·E в сообщение
Из DALL·E изображения приходят списком, в котором находятся ссылки на изображения. Увидеть эти ссылки можно в разделе Пользователи, открыв переменные пользователя, который отправлял запрос.
Если нужно, чтобы в бота сразу пришла картинка, подойдет компонент Изображение.
Так как ссылки из DALL·E приходят в виде списка, где нумерация идет с нуля, то путь до переменной, где лежит первая картинка будет таким: {{var.data.[0].url}}, вторая картинка будет здесь: {{var.data.[1].url}} и т.д. В этом шаблоне var — переменная для ответа DALL·E, которая задается в настройках.
В одном компоненте может быть выведена только одна ссылка, если ссылок больше, можно добавить несколько компонентов один за другим.
По такому же принципу изображение можно прислать с помощью Документа. Если присылать документом, то картинка в бот придет в оригинальном размере, без сжатия. Картинка будет доступна пользователю для скачивания.
Такой же шаблон поможет зашить ссылку под Кнопку.
Чтобы ссылка на изображение появилась после нажатия кнопки, добавьте Кнопки после Запроса к DALL·E, в настройках кнопки выберите чекбокс Переход на внешний URL и вставьте шаблон для вывода первой картинки {{var.data.[0].url}} в поле Переход по URL.
В сообщении можно вывести одну или несколько ссылок на изображение с предпросмотром в конце.
Для этого подойдет такой же шаблон, как в Изображении, Документе и Кнопках.
Помимо этого, для вывода в сообщении ссылки или нескольких ссылок сразу сработает хелпер stringify. С ним шаблон для вывода ссылки в бот будет таким: {{stringify var}}.
DALL·E за один раз может сгенерировать до 10 изображений, но из-за ограничений платформ, большое количество ссылок может не вывестись в одном сообщении. Если нужно получить 8-10 изображений за один раз, рекомендуем выводить ссылки двумя или более сообщениями.
Если изображения выводить по одному с помощью компонентов Изображение или Документ, они придут все по очереди.
Как принимать запросы от пользователей
С помощью Ввода от пользователя или Развилки можно принимать запросы на генерацию изображений от пользователя.
Для этого нужно вывести переменную с сообщением от пользователя в поле Текст запроса. В случае, если вы хотите дать пользователю возможность определять количество картинок, то об этом также можно спросить, записав ответ в переменную с типом данных Число.
Затем эту переменную можно вывести в настройках компонента Запрос к DALL·E в поле Сколько изображений нужно сгенерировать. В этом случае рекомендуем предупредить об ограничениях.