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