Все ноды/AI/Media (Speech / Image / Video)
Текст → Речь
Синтезирует речь (аудиофайл) из текста (TTS). Голос/формат — параметры выбранной модели из медиа-каталога.
Тип в графе: text_to_speech
ToolExec
Можно включить выход ошибки и обработать сбой отдельным путём.
Порты можно разделить на исполнение и данные (split ports).
Как попробовать
Минимальный рабочий сценарий
- Исполнение + данные
Перед запуском выберите своё подключение или базу знаний — в графе стоит REPLACE_ME.
Как применять
Нода озвучивает текст и отдаёт аудиофайл. Обратная задача — у
Речь → Текст. Как и Генерация изображения,
она работает в двух ролях: ребро из порта Аудио делает её обычным шагом графа, ребро из порта
tool_out в порт «Расширения агента» ИИ-агента — инструментом, который модель зовёт
сама, когда решит ответить голосом.
Как это работает
Голос, формат и скорость — это параметры выбранной модели, а не поля ноды: они приходят из медиа-каталога и появляются в форме после выбора модели. Голос у большинства вендоров обязателен, поэтому каталог заранее подставляет первый доступный.
Формат бывает pcm и mp3, и часть моделей принимает только mp3 — для них правильное значение
уже проставлено. Сырой PCM приходит без контейнера, поэтому платформа определяет настоящий формат по
самим байтам и при необходимости заворачивает звук в WAV: файл, который доедет до чата, открывается
плеером.
Текстового поля у ноды нет. На пути графа текст приходит только с порта Текст; в роли инструмента —
из аргументов модели. Выход Аудио — ровно один файл, сохранённый в
хранилище воркспейса.
Ход работы инструмента можно показать в чате: переключатель «Показывать ход работы в Catch» шлёт строки «загружаю / готово» в подключённую ноду Перехват вызова инструмента.
Частые ошибки
- Ищут в форме поле «Текст». Его нет: пустой вход — это ошибка ноды, а не тихий пропуск.
- Ребро
Аудио→Файлыу Выхода. Порт «Файлы» принимает только чистые данные. Включите «Разделить выходные порты» и ведите ребро изaudio_data. - Меняют модель и ждут, что голос переедет. Имена голосов у вендоров разные, значение от прежней модели не отправляется — и вы услышите голос по умолчанию либо получите отказ провайдера.
- Переключают формат ради проигрывания. Формат файла определяется по самому ответу;
pcmиmp3— это то, что просят у него, а не то, что получит слушатель. - Гонят в озвучку весь ответ модели целиком. Плата берётся за вызов, но время синтеза и размер файла растут вместе с текстом — режьте длинные ответы до ноды.
Входы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Текстtext | Исполнение + данныеexecute_data | string | показывается, когда operation_mode ≠ "as_tool" |
Выходы
| Порт | Провод | Данные | Примечания |
|---|---|---|---|
Аудиоaudio | Исполнение + данныеexecute_data | file | показывается, когда operation_mode ≠ "as_tool" |
Расширение агентаtool_out | Расширениеlink_extension | — | показывается, когда operation_mode ≠ "executable" |
Настройки
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
Режим нодыoperation_mode | string | executable | «Шаг сценария» — обычная нода с портами «Запуск» и «Успех». «Инструмент» — расширение, которое ИИ-агент вызывает сам: виден только выход «Расширение агента», а когда запускать, решает модель. Варианты: |
Модельmodel | string | google/gemini-3.1-flash-tts-preview | Модель синтеза речи из медиа-каталога (выбирается списком). Её собственные параметры (голос, формат аудио, скорость) появляются ниже после выбора модели. Варианты: |
| Дополнительно | |||
Показывать результат моделиshow_result_to_model | boolean | false | Вставить сгенерированный файл в диалог сразу после результата инструмента, чтобы модель услышала, что получилось, и могла доработать это следующим кругом. По умолчанию выключено: вставленный файл стоит входных токенов при каждой генерации. показывается при «Режим ноды» = Инструмент |
Показывать ход работы в Catchstream_progress_in_catch | boolean | true | Отправлять строки загрузки/успеха этого инструмента в подключённую ноду catch_tool_call. показывается при «Режим ноды» = Инструмент |
Подключениеconnection_id | string | "" | Необязательный коннект пространства со своим ключом провайдера (BYO). Пусто = ключ платформы из окружения. подключение: openrouter |
Общие поля
Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.
expose_error_output— Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этой ноды.split_ports_in— Показывать отдельные порты входа для выполнения и данных вместо одного объединённого.split_ports_out— Показывать отдельные порты выхода для выполнения и данных вместо одного объединённого.
Настройки выбранной модели
Появляются в форме после выбора модели — набор зависит от неё, поэтому здесь перечислено всё, что встречается.
Формат звукаresponse_format | Не каждая модель принимает оба формата — если генерация не удалась, попробуйте другой. |
Голосvoice | Идентификатор голоса у поставщика. Эта модель не публикует список своих голосов. |