Все ноды/AI/Media (Speech / Image / Video)
Генерация изображения
Генерация изображения по тексту (text2img) или по тексту + входной картинке (img2img). Параметры (size/quality/n) зависят от выбранной модели.
Тип в графе: image_generate
ToolExec
Можно включить выход ошибки и обработать сбой отдельным путём.
Порты можно разделить на исполнение и данные (split ports).
Как попробовать
Минимальный рабочий сценарий
- Исполнение + данные
Перед запуском выберите своё подключение или базу знаний — в графе стоит REPLACE_ME.
Как применять
Нода рисует изображение по текстовому описанию, а если подключить файл — перерисовывает уже существующее. А чтобы просто посмотреть на картинку и ответить по ней, отдельная нода не нужна — вложение читает сама модель в ИИ-агенте или Ответе LLM.
Роль ноды задаёт проводка. Ребро из порта Картинки в следующий шаг — обычная нода графа. Ребро из
порта tool_out в порт «Расширения агента» агента — инструмент: модель сама решает, когда рисовать, и
картинка уходит вложением в её ответ.
Как это работает
Список моделей приходит из медиа-каталога. Параметры конкретной модели — размер, качество, число изображений, seed — появляются в форме только после выбора модели, потому что у каждой модели они свои. При смене модели значения, которых новая модель не объявляет, просто не отправляются.
Подключите файл в порт Входная картинка — и ту же ноду работает как img2img: описание становится
описанием правки. У модели, которая референс не принимает, этот порт не рисуется вовсе.
В роли инструмента всё сложнее: аргументы инструмента несут только текст, поэтому «перерисуй это фото» работает через включённый переключатель «Брать картинки из сообщения» — модели отдаются картинки, приложенные пользователем к этому ходу. Результат всегда уходит пользователю; в контекст самой модели он попадает, только если включить «Показывать результат модели», а вставленная картинка стоит входных токенов при каждой генерации.
Сгенерированные файлы сохраняются в хранилище воркспейса, и вниз по графу уезжают ссылки, а не байты.
Частые ошибки
- Ребро
Картинки→Файлыу Выхода. Порт «Файлы» принимает только чистые данные, составной порт в него не подключается. Включите «Разделить выходные порты» и ведите ребро изimages_data. - Ждут одну картинку.
images— список: если модель нарисовала несколько, вниз уедут все. - Забытое ребро в
Входная картинкапосле смены модели. Порт исчезнет, а сохранённое ребро останется — и нода откажется работать вместо того, чтобы молча отправить референс в никуда. - Промпт пишут только в поле. Порт
Промптвыигрывает у поля; поле используется, когда порт ничего не принёс. - Пустой коннект вместо своего ключа. Коннект без ключа падает на ключ платформы, и генерация оплачивается как обычно. Со своим ключом (BYO) платформа генерацию не списывает.
Входы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Промптprompt | Исполнение + данныеexecute_data | string | показывается, когда operation_mode ≠ "as_tool" |
Входная картинкаimage | Данныеdata | file | несколько связей показывается, когда operation_mode ≠ "as_tool" |
Выходы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Картинкиimages | Исполнение + данныеexecute_data | file | показывается, когда operation_mode ≠ "as_tool" |
Расширение агентаtool_out | Расширениеlink_extension | — | показывается, когда operation_mode ≠ "executable" |
Настройки
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
Режим нодыoperation_mode | string | executable | «Шаг сценария» — обычная нода с портами «Запуск» и «Успех». «Инструмент» — расширение, которое ИИ-агент вызывает сам: виден только выход «Расширение агента», а когда запускать, решает модель. Варианты: |
Промптprompt | string | "" | Используется, когда порт «Промпт» ничего не доставил: не подключён или пришла пустая строка. поддерживает шаблоныперекрывается портом: prompt показывается при «Режим ноды» = Шаг сценария |
Модельmodel | string | openai/gpt-image-1 | Модель генерации изображений из медиа-каталога (выбирается списком). Её собственные параметры (размер, качество, число изображений) появляются ниже после выбора модели; модели, не принимающие референс-картинку, дополнительно скрывают порт 'image'. Варианты: |
| Дополнительно | |||
Показывать результат моделиshow_result_to_model | boolean | false | Вставить сгенерированный файл в диалог сразу после результата инструмента, чтобы модель увидела, что получилось, и могла доработать это следующим кругом. По умолчанию выключено: вставленный файл стоит входных токенов при каждой генерации. показывается при «Режим ноды» = Инструмент |
Показывать ход работы в Catchstream_progress_in_catch | boolean | true | Отправлять строки загрузки/успеха этого инструмента в подключённую ноду catch_tool_call. показывается при «Режим ноды» = Инструмент |
Брать картинки из сообщенияuse_turn_images | boolean | true | Когда ноду вызывает ИИ-агент как инструмент, отправлять изображения, приложенные пользователем к этому ходу, как референс (img2img / редактирование). Аргументы инструмента не могут нести байты, поэтому это единственный способ, которым «перерисуй это фото» доходит до провайдера. На пути сценария игнорируется — там значение берётся с порта 'image'. показывается при «Режим ноды» = Инструмент |
Подключениеconnection_id | string | "" | Необязательный коннект пространства со своим ключом провайдера (BYO). Пусто = ключ платформы из окружения. подключение: openrouter |
Общие поля
Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.
expose_error_output— Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этой ноды.split_ports_in— Показывать отдельные порты входа для выполнения и данных вместо одного объединённого.split_ports_out— Показывать отдельные порты выхода для выполнения и данных вместо одного объединённого.
Настройки выбранной модели
Появляются в форме после выбора модели — набор зависит от неё, поэтому здесь перечислено всё, что встречается.
Соотношение сторонaspect_ratio | |
Фонbackground | |
Сколько картинокn | |
Сжатиеoutput_compression | |
Формат файлаoutput_format | |
Качествоquality | |
Разрешениеresolution | |
Зерно генерацииseed | |
Размерsize |