К сценариям
Конструктор

Управление потоком

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

Если / иначе и выбор варианта

Модуль ветвления умеет работать в двух режимах. В настройках модуля вы явно выбираете нужный.

Режим «Если / иначе»
Binary switch
Картинка

Результат анализа

1
Если / иначе

Switch

2
Если да
Если нет
Доработать

Ветка

Продолжить

Ветка

Результат ветки

Объединение

2
Подписи на исходящих линиях:Если даЕсли нет

Сравнивает значение с ожидаемым (равно, больше, меньше, содержит и т.д.). Подходит для «если оценка ниже X — отправить на доработку».

Режим «Выбор варианта»
Case switch
Выбор пользователя

Входной модуль

Выбор варианта

Switch

3
case = light
case = dark
Другое
Светлая версия

Ветка

Тёмная версия

Ветка

Запасной вариант

Ветка

Результат ветки

Объединение

3
Подписи на исходящих линиях:case = lightcase = darkДругое

Принимает значение «выбора» и выбирает ветку по точному совпадению. Удобно, когда пользователь сам выбирает один из нескольких сценариев.

Параметр модели вместо ветвления
Если вы хотите дать выбрать одну из нескольких совместимых моделей — обычно лучше использовать готовый модуль-диспетчер, а не ветвление через Switch. Ветвление нужно, когда разные варианты требуют разных цепочек.

Объединение веток

Когда после Switch ветки сходятся обратно в одну точку.

После ветвления модуль ниже обычно ждёт результата только одной ветки — той, которая реально выполнилась. Чтобы корректно «передать дальше» этот единственный результат, используйте модуль «Результат выбранной ветки». Он сам разберётся, какая ветка отработала, и передаст её результат дальше.

Объединение веток после Switch
Switch

Выбор ветки

2
если да
Ветка A

для коротких

Результат выбранной ветки

Объединение

2
Дальше

Следующий модуль

8 ₽
1
Если в одну точку соединить ветки без модуля «Результат выбранной ветки» — сценарий честно остановится с понятной ошибкой настройки. Это сделано специально, чтобы не было неопределённых результатов.

Цикл по списку (ForEach)

Когда нужно повторить кусок сценария для каждого элемента: для каждого фото, для каждой строки, для каждого варианта.

Тело цикла
Цикл: начало

Цикл по списку

цикл
Картинка

Генерация изображения

8 ₽/шт
13/10
Цикл: конец

Сбор результатов

цикл3/10
Склейка

Утилита

1

Цикл всегда состоит из пары модулей «Цикл: начало» и «Цикл: конец». Между ними — тело цикла, которое выполняется для каждого элемента списка. После «конца» можно дальше собрать общий результат, например, склеить все картинки в одну сетку.

Ограничения первой версии
Внутри цикла можно ветвить и собирать обратно через модуль «Результат ветки», но пока нельзя:
  • вкладывать один цикл в другой;
  • использовать «Ручную проверку» внутри цикла;
  • выводить из тела цикла связь наружу в обход «конца».

Повтор упавших элементов цикла

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

Когда цикл проходит по списку, в деталях запуска для модулей цикла появляется отдельная панель со списком элементов: для каждого видно номер, превью входа и индивидуальный статус («Готово», «Ошибка», «В работе», «Пропущено»). Над списком — три действия:

  • Повторить упавшие — берёт все элементы со статусом «Ошибка» и запускает их заново. Успешные элементы не трогаются: их результаты остаются в выходном списке цикла.
  • Повторить выбранные — рядом с каждым элементом есть чекбокс. Удобно, когда вы хотите перезапустить и упавшие, и пару подозрительных «успешных» элементов.
  • Продолжить с упавших — особый режим: цикл считает упавшие элементы «как будто пропущенными» и переходит к модулям после цикла. Полезно, когда вам важен не каждый элемент, а итоговая склейка из тех, что получились.

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

Элементы цикла
Картинки · цикл по списку
3 из 5 готово · 2 ошибок
#1cat.jpgГотово
#2dog.jpgГотово
#3fox.jpgОшибка
#4owl.jpgГотово
#5bee.jpgОшибка
Повторить упавшиеПовторить выбранныеПродолжить с упавших
Откуда смотреть
Панель элементов открывается в деталях запуска: клик по нужному модулю-границе цикла («Цикл: начало» или «Цикл: конец»). Сами действия повтора доступны только автору сценария — у зрителей публикации этих кнопок нет.

Ручная проверка

Сценарий ставится на паузу и ждёт вашего решения.

Модуль «Ручная проверка» полезен, когда хочется проверить промежуточный результат глазами и выбрать, с чем идти дальше. Пока вы не дали ответ, сценарий честно ждёт и не списывает баланс за следующие шаги.

В интерфейсе это выглядит как отдельный статус ожидания: вы выбираете подходящий результат и после этого сценарий продолжает выполнение.

Группы и заметки

Чтобы крупные сценарии не превращались в кашу.

Группа
Подготовка кадров
Идея

Входной модуль: Текст

Картинки

Генерация изображения

8 ₽
1
Апскейл

Увеличение

4 ₽
1

Группа — это рамка вокруг нескольких модулей с названием и возможностью свернуть. На выполнение сценария группа не влияет: это исключительно средство навигации и читаемости.

Заметки — небольшие текстовые блоки прямо в рабочей области. Их удобно оставлять авторам, чтобы напоминать «здесь поменяй модель», «здесь промпт можно укоротить» и так далее.