Гайд по n8n

Узнайте, как использовать Nexara API в своём n8n пайплайне.

n8n позволяет вызвать Nexara API без единой строки кода. Есть два способа:

Community-нода Nexara (рекомендуется) — отдельный узел с готовыми операциями транскрибации и диаризации.
Узел HTTP Request — ручная настройка запроса, если community-ноды недоступны.

Способ 1: Community-нода Nexara (рекомендуется)

Отдельный узел n8n-nodes-nexara избавляет от ручной настройки запроса: транскрибация, диаризация, роли говорящих и структурированный вывод через LLM доступны как обычные операции узла.

Установите ноду

В n8n откройте Settings → Community Nodes → Install и введите:

n8n-nodes-nexara

Подробнее — в документации n8n по community-нодам.

Добавьте учётные данные (Credentials)

Создайте в панели Nexara API-ключ. Затем в n8n добавьте учётные данные типа Nexara API и вставьте ключ — он будет отправляться как Bearer-токен в каждом запросе.

У учётных данных нет кнопки «Test»: в API нет отдельного health-эндпоинта. Чтобы проверить ключ, запустите операцию Transcribe на коротком аудио.

Выберите операцию

Добавьте узел Nexara и выберите операцию:

Операция	Что делает
Transcribe	Транскрибирует аудио в текст и дожидается результата.
Diarize	Транскрибирует и размечает говорящих, с опциональными ролями.
Create Job	Отправляет длинное аудио на отложенную обработку. Возвращает задачу сразу либо опрашивает её до завершения.
Get Job	Получает отложенную задачу по её ID.

Аудио передаётся либо как бинарный файл из предыдущего узла, либо как URL — сервер скачает файл сам.

Настройте параметры

Основные опции узла:

Response Format — JSON, Verbose JSON, Text, SRT или VTT.
Language — код ISO-639-1 (например, ru, en) или пусто для автоопределения.
LLM Prompt / LLM JSON Schema — прогнать расшифровку через LLM и, при необходимости, получить строго структурированный JSON. Промпт автоматически включает Verbose JSON.
Timestamp Granularity, Profanity Filter, Dictionary, Model.
Для диаризации: Number of Speakers, Diarization Setting и Roles — auto, JSON-массив вида ["client","agent"] или JSON-объект «метка → описание».

Примеры

Транскрибация загруженного файла

Узел, отдающий бинарное аудио (например, HTTP Request или Read Binary File).
Nexara → Transcribe, Input Type — Binary File, Input Binary Field — data.

Диаризация звонка с ролями

Nexara → Diarize.
В Diarization Options задайте Roles — ["client","agent"].

Длинное аудио (отложенная обработка)

Nexara → Create Job с включённым Wait for Completion — узел сам опрашивает задачу и возвращает результат. За неуспешную задачу оплата не списывается.
Либо оставьте опрос выключенным и позже вызовите Get Job с полученным Job ID (в другом воркфлоу или запуске). Результаты хранятся 12 часов после создания.

Способ 2: Узел HTTP Request (вручную)

Если community-ноды недоступны, Nexara API можно вызвать напрямую через встроенный узел HTTP Request. Ниже — пошаговая настройка транскрибации аудиофайла.

Добавьте узел HTTP Request

Найдите и добавьте узел HTTP Request в ваш рабочий процесс n8n.

Импортируйте команду cURL

Нажмите Import cURL в настройках узла HTTP Request и вставьте команду ниже.

curl --request POST \
  --url https://api.nexara.ru/v1/audio/transcriptions \
  --header 'Authorization: Bearer YOUR_NEXARA_API_KEY' \
  --header 'Content-Type: multipart/form-data'

Не забудьте заменить YOUR_NEXARA_API_KEY на ваш реальный API-ключ Nexara.

Настройте тело запроса (Body Parameters)

Прокрутите вниз до раздела Body в параметрах узла.
Убедитесь, что Body Content Type установлен как Form-Data.
В разделе Body Parameters нажмите Add Parameter.
Parameter Type — n8n Binary File.
Name — file.
Input Data Field Name — data.

Настройка Body Parameters для файла

Поле data предполагает, что бинарный файл приходит из предыдущего узла (например, Read Binary File) и доступен под именем data. Если имя поля другое — укажите своё. А если у вас есть ссылка на файл, а не сам файл, передайте её напрямую через параметр url.

Готово — при необходимости добавьте параметры

Базовая настройка завершена: узел уже отправляет файл на транскрибацию.

Чтобы добавить другие параметры API (например, language или response_format), создайте новые параметры в Body Parameters — обычно с типом String в поле Parameter Type:

Дополнительные параметры запроса

Убедитесь, что перед узлом HTTP Request есть узел, который читает аудиофайл и делает его бинарные данные доступными (обычно под именем поля data). Либо передавайте ссылку на файл через параметр url.
Чтобы выполнить диаризацию (разделение на говорящих), добавьте параметр task со значением diarize.

Подробнее о всех доступных параметрах API читайте в Референсе API.

Гайд по n8n

On this page