{"_id":"@artymaximus/n8n-nodes-yc","name":"@artymaximus/n8n-nodes-yc","dist-tags":{"latest":"0.13.3"},"versions":{"0.13.3":{"name":"@artymaximus/n8n-nodes-yc","version":"0.13.3","description":"n8n nodes for Yandex Cloud services","keywords":["n8n-community-node-package"],"license":"MIT","homepage":"https://github.com/ArtyMaximus/n8n-nodes-yc#readme","author":{"name":"Nikolay Matrosov","email":"nikolay.matrosov@gmail.com"},"repository":{"type":"git","url":"git+https://github.com/ArtyMaximus/n8n-nodes-yc.git"},"engines":{"node":">=22.15.0"},"main":"index.js","scripts":{"build":"npx rimraf dist && tsc && tsc-alias && gulp build:icons && npm run validate:nodes","dev":"tsc --watch","format":"prettier nodes credentials --write","lint":"eslint nodes credentials package.json","lintfix":"eslint nodes credentials package.json --fix","test":"jest","test:watch":"jest --watch","test:coverage":"jest --coverage","validate:nodes":"node scripts/validate-nodes.js","prepublishOnly":"npm run build && eslint -c eslint.config.prepublish.js --ignore-pattern '**/*.test.ts' nodes credentials package.json","git-tag":"git tag v`cat package.json | jq -r '.version' | awk -F. '{print $1}'` -f &&  git tag v`cat package.json | jq -r '.version'` -f","changelog:promote":"node scripts/promote-changelog.js"},"n8n":{"n8nNodesApiVersion":1,"credentials":["dist/credentials/YandexCloudAuthorizedApi.credentials.js","dist/credentials/YandexCloudFomoApi.credentials.js","dist/credentials/YandexCloudGptApi.credentials.js","dist/credentials/YandexCloudStaticApi.credentials.js","dist/credentials/YandexCloudYdbApi.credentials.js"],"nodes":["dist/nodes/YandexArt/YandexArt.node.js","dist/nodes/YandexCloudFomo/YandexCloudFomo.node.js","dist/nodes/LMChatYandexGpt/LmChatYandexGpt.node.js","dist/nodes/YandexCloudPostbox/YandexCloudPostbox.node.js","dist/nodes/YandexCloudMessageQueue/YandexCloudMessageQueue.node.js","dist/nodes/YandexCloudMessageQueue/YandexCloudMessageQueueTrigger.node.js","dist/nodes/YandexCloudDataStreams/YandexCloudDataStreams.node.js","dist/nodes/YandexCloudDataStreams/YandexCloudDataStreamsTrigger.node.js","dist/nodes/YandexCloudFunctions/YandexCloudFunctions.node.js","dist/nodes/YandexCloudObjectStorage/YandexCloudObjectStorage.node.js","dist/nodes/YandexCloudSpeechKit/YandexCloudSpeechKit.node.js","dist/nodes/YandexCloudSpeechKitSTT/YandexCloudSpeechKitStt.node.js","dist/nodes/YandexCloudCompute/YandexCloudCompute.node.js","dist/nodes/YandexCloudContainers/YandexCloudContainers.node.js","dist/nodes/YandexCloudWorkflows/YandexCloudWorkflows.node.js","dist/nodes/YandexCloudTranslate/YandexCloudTranslate.node.js","dist/nodes/YandexCloudYDB/YandexCloudYdb.node.js","dist/nodes/YandexCloudSearch/YandexCloudSearch.node.js","dist/nodes/YandexCloudVisionOcr/YandexCloudVisionOcr.node.js","dist/nodes/YandexCloudLogging/YandexCloudLogging.node.js","dist/nodes/YandexCloudLockbox/YandexCloudLockbox.node.js"]},"devDependencies":{"@eslint/eslintrc":"^3.3.1","@eslint/js":"^9.39.0","@types/jest":"^30.0.0","@types/lodash":"^4.17.20","@types/node":"^24.10.1","@types/proxy-from-env":"^1.0.4","@types/tmp":"^0.2.6","@types/xml2js":"^0.4.14","@typescript-eslint/parser":"^8.47.0","eslint":"^9.39.1","eslint-plugin-n8n-nodes-base":"^1.16.4","globals":"^16.5.0","gulp":"^5.0.1","jest":"^30.2.0","jest-mock-extended":"^4.0.0","n8n-core":"^1.117.0","nock":"^14.0.10","prettier":"^3.6.2","ts-jest":"^29.4.5","tsc-alias":"^1.8.16","typescript":"^5.9.3"},"dependencies":{"@aws-sdk/client-kinesis":"^3.934.0","@aws-sdk/client-s3":"^3.934.0","@aws-sdk/client-sesv2":"^3.934.0","@aws-sdk/client-sqs":"^3.934.0","@aws-sdk/core":"^3.932.0","@aws-sdk/s3-request-presigner":"^3.934.0","@aws-sdk/types":"^3.930.0","@grpc/grpc-js":"1.14.1","@langchain/core":"^0.3.33","@langchain/openai":"^0.6.16","@n8n/json-schema-to-zod":"^1.5.0","@yandex-cloud/nodejs-sdk":"^3.1.0","@ydbjs/core":"^6.1.0","@ydbjs/query":"^6.0.7","@ydbjs/value":"^6.0.5","generate-schema":"^2.6.0","lodash":"^4.17.21","nice-grpc":"^2.1.14","openai":"^4.76.1","proxy-from-env":"^1.1.0","tmp-promise":"^3.0.3","undici":"^7.16.0","xml2js":"^0.6.2"},"peerDependencies":{"n8n-workflow":"*"},"resolutions":{"@langchain/core":"^0.3.33","@grpc/grpc-js":"1.14.1"},"overrides":{"@langchain/core":"^0.3.33","@grpc/grpc-js":"1.14.1"},"_id":"@artymaximus/n8n-nodes-yc@0.13.3","gitHead":"5c93dd45d6e01b397b255edc098663ddcc91fb2a","bugs":{"url":"https://github.com/ArtyMaximus/n8n-nodes-yc/issues"},"_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-k1x0gk5jeQKJncI3aSuljNMEEU5Whi+OvetLg5HlS0StmTHG1qlHobj8xvPjeKJszY8phkL8EAuxlwHlH3Cv3Q==","shasum":"7e6a4ddb36fad9fc257f7d785fb4bfd2e4eb58fc","tarball":"https://registry.npmjs.org/@artymaximus/n8n-nodes-yc/-/n8n-nodes-yc-0.13.3.tgz","fileCount":251,"unpackedSize":2719195,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDzlDZfISLFg7FNUhKw9WWQUGYIGtBPD6G75sXL0FCRIAIgIrfnbErq0iKxoseetJGxdp6mshTLCWxjTd13RXXn6dE="}]},"_npmUser":{"name":"artymaximus","email":"aza-artyom@yandex.ru"},"directories":{},"maintainers":[{"name":"artymaximus","email":"aza-artyom@yandex.ru"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-yc_0.13.3_1779449586221_0.5243018560699524"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-22T11:33:06.018Z","0.13.3":"2026-05-22T11:33:06.405Z","modified":"2026-05-22T11:33:06.594Z"},"maintainers":[{"name":"artymaximus","email":"aza-artyom@yandex.ru"}],"description":"n8n nodes for Yandex Cloud services","homepage":"https://github.com/ArtyMaximus/n8n-nodes-yc#readme","keywords":["n8n-community-node-package"],"repository":{"type":"git","url":"git+https://github.com/ArtyMaximus/n8n-nodes-yc.git"},"author":{"name":"Nikolay Matrosov","email":"nikolay.matrosov@gmail.com"},"bugs":{"url":"https://github.com/ArtyMaximus/n8n-nodes-yc/issues"},"license":"MIT","readme":"# Описание нод пакета n8n-nodes-yc\r\n\r\n> **Решение проблем при обновлении:** Если обновление пакета через интерфейс n8n не работает корректно, используйте следующие шаги:\r\n>\r\n> 1. Удалить старую версию\r\n> 2. Очистить папку `.n8n/nodes`\r\n> 3. Перезапустить n8n\r\n> 4. Установить новую версию\r\n>\r\n> Более надёжный способ обновления находится в разработке.\r\n\r\nПакет интеграций для работы с сервисами Yandex Cloud в n8n.\r\n\r\n## Содержание\r\n\r\n1. [Yandex Cloud GPT Chat Model](#yandex-cloud-gpt-chat-model)\r\n2. [Yandex Cloud Foundation Models](#yandex-cloud-foundation-models)\r\n3. [Yandex Object Storage](#yandex-object-storage)\r\n4. [Yandex Cloud Functions](#yandex-cloud-functions)\r\n5. [Yandex Cloud Containers](#yandex-cloud-containers)\r\n6. [Yandex Cloud Compute](#yandex-cloud-compute)\r\n7. [Yandex Cloud Data Streams](#yandex-cloud-data-streams)\r\n8. [Yandex Cloud Message Queue](#yandex-cloud-message-queue)\r\n9. [Yandex Cloud Postbox](#yandex-cloud-postbox)\r\n10. [Yandex Cloud SpeechKit](#yandex-cloud-speechkit)\r\n11. [Yandex Cloud SpeechKit STT](#yandex-cloud-speechkit-stt)\r\n12. [Yandex Cloud Translate](#yandex-cloud-translate)\r\n13. [Yandex Cloud Workflows](#yandex-cloud-workflows)\r\n14. [Yandex Cloud YDB](#yandex-cloud-ydb)\r\n15. [Yandex Cloud Search](#yandex-cloud-search)\r\n16. [Yandex Cloud Vision OCR](#yandex-cloud-vision-ocr)\r\n17. [Yandex Cloud Logging](#yandex-cloud-logging)\r\n18. [Yandex Cloud YandexART](#yandex-cloud-yandexart)\r\n19. [Yandex Cloud Lockbox](#yandex-cloud-lockbox)\r\n\r\n---\r\n\r\n## Yandex Cloud GPT Chat Model\r\n\r\n**Нода для интеграции с Yandex Cloud Foundation Models API в качестве языковой модели для LangChain.** Эта нода является компонентом AI-цепочек и представляет собой Chat Model, совместимую с фреймворком LangChain. Предназначена для продвинутого использования в AI-агентах и цепочках обработки (AI Chain, AI Agent). Нода не имеет входов и выводит объект языковой модели, который можно подключать к другим AI-компонентам n8n.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Model** | Resource Locator | ID модели YandexGPT (например, `yandexgpt/latest`) |\r\n| **Maximum Tokens** | Number | Максимальное количество токенов в ответе (до 8000) |\r\n| **Temperature** | Number | Контроль случайности генерации (0-1, по умолчанию 0.6) |\r\n| **Timeout** | Number | Таймаут запроса в миллисекундах (по умолчанию 60000) |\r\n| **Max Retries** | Number | Максимальное количество повторных попыток (по умолчанию 2) |\r\n\r\n**Аутентификация:** Использует API ключ через credentials `yandexCloudGptApi` с передачей folder ID в заголовке `x-folder-id`. Поддерживает настройку базового URL API. Нода совместима с OpenAI API протоколом, что позволяет использовать стандартные LangChain инструменты. Идеально подходит для создания чат-ботов, RAG-систем и AI-агентов с использованием российских языковых моделей.\r\n\r\n---\r\n\r\n## Yandex Cloud Foundation Models\r\n\r\n**Нода для работы с Foundation Models API Yandex Cloud, предоставляющая прямой доступ к генеративным языковым моделям YandexGPT через REST API.** В отличие от Chat Model версии, эта нода работает как обычная трансформационная нода с входами и выходами Main-типа, позволяя отправлять запросы к API и получать JSON-ответы в контексте стандартного workflow.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Resource** | Options | Тип ресурса (Chat) |\r\n| **Operation** | Options | Операция для выполнения |\r\n\r\n**Ресурсы и операции:**\r\n\r\n- **Chat** - работа с чат-функциональностью модели\r\n\r\n**Аутентификация:** Использует API ключ через credentials `yandexCloudFomoApi`. Поддерживает настройку базового URL и автоматическую обработку HTTP ошибок (ignoreHttpStatusErrors). Включает выбор модели из выпадающего списка (аналогично LMChatYandexGpt) и расширенные сообщения об ошибках с детальными ответами API. Нода подходит для простых сценариев генерации текста, где не требуется сложная интеграция с LangChain, но нужна прямая работа с API Yandex Cloud для создания диалогов, генерации контента и обработки естественного языка в автоматизированных процессах.\r\n\r\n---\r\n\r\n## Yandex Object Storage\r\n\r\n**Нода для полноценного управления объектным хранилищем Yandex Cloud, совместимым с Amazon S3 API.** Предоставляет исчерпывающий набор операций для работы как с bucket'ами (контейнерами), так и с объектами (файлами), используя AWS SDK для обеспечения максимальной совместимости и надежности.\r\n\r\n| Параметр | Тип | Ресурсы | Операции |\r\n|----------|-----|---------|----------|\r\n| **Bucket** | Resource | Bucket | Create, Delete, Get, List, Set ACL, Set Versioning |\r\n| **Object** | Resource | Object | Upload, Download, Copy, Move, Delete, Get, List, Set ACL, Get Presigned URL |\r\n\r\n**Операции с Bucket:**\r\n\r\n- **Create** - создание нового bucket с настройкой ACL\r\n- **Delete** - удаление пустого bucket\r\n- **Get** - получение информации о bucket (location, metadata)\r\n- **List** - перечисление всех доступных bucket'ов\r\n- **Set ACL** - настройка прав доступа (private, public-read, public-read-write, authenticated-read)\r\n- **Set Versioning** - включение/отключение версионирования объектов\r\n\r\n**Операции с Object:**\r\n\r\n- **Upload** - загрузка из бинарных данных, текста или JSON с настройкой content-type, storage class (Standard/Cold/Ice) и метаданных. Возвращает поле `objectUrl` с полным URL объекта (например, `https://storage.yandexcloud.net/my-bucket/file.txt`)\r\n- **Download** - скачивание объекта в бинарный формат\r\n- **Copy** - копирование между bucket'ами с сохранением метаданных. Возвращает поле `objectUrl` с URL объекта назначения\r\n- **Move** - перемещение с автоматическим удалением источника. Возвращает поле `objectUrl` с URL объекта назначения\r\n- **Delete** - удаление объекта\r\n- **Get** - получение метаданных (size, content-type, ETag, версия)\r\n- **List** - перечисление объектов с фильтрацией по префиксу и пагинацией (до 1000 объектов)\r\n- **Set ACL** - настройка прав доступа на уровне объекта\r\n- **Get Presigned URL** - генерация временных подписанных URL для безопасного доступа\r\n\r\n**Аутентификация:** Использует статические ключи доступа (access key ID и secret access key) через credentials `yandexCloudStaticApi`. Поддерживает resource locator для удобного выбора bucket'ов из списка или ввода имени вручную. Нода идеально подходит для резервного копирования, хранения файлов пользователей, CDN-интеграций и организации data lake в облаке.\r\n\r\n---\r\n\r\n## Yandex Cloud Functions\r\n\r\n**Нода для вызова serverless-функций в Yandex Cloud Functions через HTTP-эндпоинты.** Позволяет запускать облачные функции с передачей параметров и получением результатов выполнения, автоматически управляя аутентификацией через IAM-токены.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Folder ID** | String | ID папки для поиска функций (по умолчанию из credentials) |\r\n| **Function** | Options | Выбор функции из списка или указание ID |\r\n| **HTTP Method** | Options | GET или POST |\r\n| **Request Body** | String (JSON) | Тело запроса для POST-метода |\r\n| **Query Parameters** | Collection | Коллекция query-параметров (name/value) |\r\n| **Headers** | Collection | Дополнительные HTTP-заголовки |\r\n\r\n**Процесс выполнения:**\r\n\r\n1. Автоматическая загрузка списка доступных функций из указанной папки через SDK\r\n2. Получение IAM-токена из service account credentials\r\n3. Формирование HTTP-запроса к эндпоинту `https://functions.yandexcloud.net/{functionId}`\r\n4. Добавление заголовка Authorization с Bearer-токеном\r\n5. Выполнение запроса и парсинг ответа (автоматическое определение JSON)\r\n\r\n**Возвращаемые данные:**\r\n\r\n- `statusCode` - HTTP статус ответа\r\n- `headers` - заголовки ответа\r\n- `body` - тело ответа (объект или строка)\r\n\r\n**Аутентификация:** Использует service account JSON через credentials `yandexCloudAuthorizedApi` для автоматического получения IAM-токенов. Валидирует JSON-тело запроса перед отправкой. Нода идеально подходит для интеграции бизнес-логики, написанной на Python, Node.js, Go и других языках, в n8n workflows, обеспечивая возможность выполнения сложных вычислений и обработки данных в serverless-архитектуре.\r\n\r\n---\r\n\r\n## Yandex Cloud Containers\r\n\r\n**Нода для вызова serverless-контейнеров в Yandex Cloud Serverless Containers, предоставляющая возможность запуска контейнеризированных приложений через HTTP.** Функционал аналогичен Yandex Cloud Functions, но работает с Docker-контейнерами, что позволяет использовать любые зависимости и окружения.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Folder ID** | String | ID папки для поиска контейнеров |\r\n| **Container** | Options | Выбор контейнера из списка или указание ID |\r\n| **HTTP Method** | Options | GET или POST |\r\n| **Request Body** | String (JSON) | Тело запроса для POST-метода |\r\n| **Query Parameters** | Collection | URL-параметры запроса |\r\n| **Headers** | Collection | Пользовательские HTTP-заголовки |\r\n\r\n**Процесс работы:**\r\n\r\n1. Загрузка списка доступных контейнеров через SDK\r\n2. Получение URL контейнера (поле `url`)\r\n3. Генерация IAM-токена для аутентификации\r\n4. Выполнение HTTP-запроса к URL контейнера\r\n5. Обработка и возврат ответа\r\n\r\n**Возвращаемые данные:**\r\n\r\n- `statusCode` - HTTP код ответа\r\n- `headers` - заголовки ответа\r\n- `body` - тело ответа (автоматический парсинг JSON)\r\n\r\n**Аутентификация:** Service account JSON с автоматическим получением IAM-токенов через `yandexCloudAuthorizedApi`. Поддерживает валидацию JSON перед отправкой. Отличается от Functions тем, что использует полные Docker-образы, что дает больше гибкости в выборе runtime, библиотек и системных зависимостей. Подходит для запуска ML-моделей, сложных приложений с множеством зависимостей и микросервисов в рамках n8n workflows.\r\n\r\n---\r\n\r\n## Yandex Cloud Compute\r\n\r\n**Нода для управления виртуальными машинами в Yandex Compute Cloud, предоставляющая базовые операции запуска и остановки инстансов.** Использует официальный Yandex Cloud SDK для взаимодействия с Compute API.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Resource** | Options | Тип ресурса (Instance) |\r\n| **Operation** | Options | Start или Stop |\r\n| **Folder ID** | String | ID папки с виртуальными машинами |\r\n| **Instance** | Options | Выбор VM из списка или указание ID |\r\n\r\n**Операции:**\r\n\r\n- **Start** - запуск остановленной виртуальной машины\r\n- **Stop** - остановка работающей виртуальной машины\r\n\r\n**Процесс выполнения:**\r\n\r\n1. Парсинг service account JSON credentials\r\n2. Создание SDK сессии с аутентификацией\r\n3. Получение списка инстансов из указанной папки\r\n4. Выполнение операции start/stop через InstanceServiceClient\r\n5. Возврат информации об операции\r\n\r\n**Возвращаемые данные:**\r\n\r\n- `success` - статус выполнения\r\n- `operation` - тип операции (start/stop)\r\n- `instanceId` - ID виртуальной машины\r\n- `operationId` - ID операции в Yandex Cloud\r\n- `done` - завершена ли операция\r\n- `metadata` - метаданные операции\r\n\r\n**Аутентификация:** Service account JSON через `yandexCloudAuthorizedApi` с валидацией обязательных полей (serviceAccountId, accessKeyId, privateKey). Нода показывает статус VM при выборе из списка (RUNNING, STOPPED и т.д.). Идеально подходит для автоматизации управления инфраструктурой: запуск VM по расписанию, остановка для экономии средств, интеграция с мониторингом и системами оповещения.\r\n\r\n---\r\n\r\n## Yandex Cloud Data Streams\r\n\r\n**Нода для работы с потоковой обработкой данных через Yandex Cloud Data Streams (YDS), совместимый с Apache Kafka и Amazon Kinesis API.** Обеспечивает высокопроизводительную передачу данных между приложениями с гарантией доставки и порядка сообщений.\r\n\r\n| Параметр | Тип | Ресурсы | Операции |\r\n|----------|-----|---------|----------|\r\n| **Record** | Resource | Record | Put, Put Multiple |\r\n| **Stream** | Resource | Stream | Describe, List |\r\n\r\n**Операции с Record:**\r\n\r\n- **Put** - отправка одной записи с выбором типа данных (String/JSON), указанием partition key и опциональных параметров (explicit hash key, sequence number)\r\n- **Put Multiple** - пакетная отправка записей в двух режимах:\r\n  - **Define Records** - ручное определение записей через UI\r\n  - **Use Input Data** - автоматическое использование входящих элементов с маппингом полей\r\n\r\n**Операции со Stream:**\r\n\r\n- **Describe** - получение детальной информации о потоке (статус, retention period, shards, encryption)\r\n- **List** - перечисление всех доступных потоков с лимитом\r\n\r\n**Параметры отправки:**\r\n\r\n- `streamName` - имя потока (формат: `/ru-central1/{folder-id}/{database-id}/{stream-name}`)\r\n- `data` - данные для отправки (строка или JSON)\r\n- `partitionKey` - ключ для определения shard'а\r\n- `explicitHashKey` - явное указание hash для routing\r\n- `dataField` - поле с данными при использовании input data\r\n- `partitionKeyField` - поле с partition key\r\n\r\n**Возвращаемые данные:**\r\n\r\n- Для Put: `shardId`, `sequenceNumber`, `encryptionType`\r\n- Для Put Multiple: `successCount`, `failedCount`, детальная информация по каждой записи\r\n- Для Describe: полная информация о потоке, shards с hash ranges\r\n- Для List: список имен потоков\r\n\r\n**Аутентификация:** Статические ключи через `yandexCloudStaticApi`, использует Kinesis-совместимый endpoint. Поддерживает resource locator для удобного выбора потоков. Нода подходит для построения real-time аналитики, потоковой ETL-обработки, сбора логов и метрик, интеграции микросервисов с гарантией доставки сообщений и возможностью горизонтального масштабирования через sharding.\r\n\r\n---\r\n\r\n## Yandex Cloud Message Queue\r\n\r\n**Нода для отправки сообщений в очереди Yandex Cloud Message Queue (YMQ), полностью совместимые с Amazon SQS API.** Предоставляет надежную асинхронную передачу сообщений между компонентами распределенных систем с поддержкой FIFO и стандартных очередей.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Resource** | Options | Message |\r\n| **Operation** | Options | Send |\r\n| **Queue** | Resource Locator | Выбор очереди из списка или указание URL |\r\n| **Message Body** | String | Содержимое сообщения (до 256 KB) |\r\n\r\n**Дополнительные поля:**\r\n\r\n- **Delay Seconds** - задержка доставки сообщения (0-900 секунд)\r\n- **Message Deduplication ID** - токен для дедупликации (обязателен для FIFO)\r\n- **Message Group ID** - группировка сообщений (обязателен для FIFO)\r\n\r\n**Message Attributes:**\r\nКоллекция атрибутов сообщения с настройкой:\r\n\r\n- `name` - имя атрибута\r\n- `dataType` - тип данных (String, Number, Binary)\r\n- `value` - значение атрибута\r\n\r\n**Возвращаемые данные:**\r\n\r\n- `messageId` - уникальный ID сообщения\r\n- `md5OfMessageBody` - MD5 хеш тела сообщения\r\n- `md5OfMessageAttributes` - MD5 хеш атрибутов\r\n- `sequenceNumber` - порядковый номер (для FIFO)\r\n- `success` - статус отправки\r\n- `queueUrl` - URL очереди\r\n\r\n**Аутентификация:** Статические ключи через `yandexCloudStaticApi`, использует endpoint `https://message-queue.api.cloud.yandex.net`. Поддерживает как стандартные очереди (at-least-once delivery, best-effort ordering), так и FIFO-очереди (exactly-once processing, strict ordering). Нода идеально подходит для построения event-driven архитектур, разделения монолитов на микросервисы, буферизации нагрузки между компонентами, обработки фоновых задач и обеспечения отказоустойчивости через асинхронную коммуникацию.\r\n\r\n---\r\n\r\n## Yandex Cloud Postbox\r\n\r\n**Нода для отправки транзакционных email через Yandex Cloud Postbox, использующий Amazon SES v2 API.** Предоставляет надежную доставку писем с поддержкой HTML-шаблонов и переменных, с гарантированной репутацией IP-адресов Yandex Cloud.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Resource** | Options | Email |\r\n| **Operation** | Options | Send |\r\n| **Email Type** | Options | Simple или Template |\r\n| **From Email** | String | Email отправителя (домен должен быть верифицирован) |\r\n| **To Email** | String | Email получателя (можно несколько через запятую) |\r\n\r\n**Simple Email (простой режим):**\r\n\r\n- **Subject** - тема письма\r\n- **HTML Body** - HTML-версия письма\r\n- **Text Body** - текстовая версия для клиентов без HTML\r\n\r\n**Template Email (шаблонный режим):**\r\n\r\n- **Template Subject** - тема с переменными `{{variable}}`\r\n- **Template HTML** - HTML-шаблон с плейсхолдерами\r\n- **Template Text** - текстовая версия шаблона (опционально)\r\n- **Template Data** - JSON-объект с данными для подстановки\r\n\r\n**Процесс отправки:**\r\n\r\n1. Парсинг списка получателей (разделение по запятой)\r\n2. Формирование структуры Content (Simple или Template)\r\n3. Подстановка переменных в шаблон (если используется)\r\n4. Отправка через SES API с charset UTF-8\r\n5. Получение Message ID\r\n\r\n**Возвращаемые данные:**\r\n\r\n- `messageId` - уникальный ID отправленного письма\r\n- `success` - статус отправки\r\n- `from` - адрес отправителя\r\n- `to` - массив адресов получателей\r\n- `subject` - тема письма\r\n- `emailType` - тип письма (simple/template)\r\n\r\n**Аутентификация:** Статические ключи через `yandexCloudStaticApi`, использует endpoint `https://postbox.cloud.yandex.net`. Требует предварительной верификации домена в Yandex Cloud. Поддерживает множественных получателей и шаблонизацию для персонализации. Нода подходит для отправки уведомлений, подтверждений регистрации, сброса паролей, отчетов, маркетинговых рассылок и любых транзакционных email с высокой доставляемостью и детальной аналитикой.\r\n\r\n---\r\n\r\n## Yandex Cloud SpeechKit\r\n\r\n**Нода для синтеза речи (Text-to-Speech) с использованием Yandex SpeechKit API v3, предоставляющая высококачественную генерацию аудио из текста.** Поддерживает множество голосов, эмоциональные роли и гибкую настройку параметров синтеза.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Resource** | Options | Speech |\r\n| **Operation** | Options | Synthesize |\r\n| **Text** | String | Текст для синтеза (многострочный) |\r\n| **Voice** | Options | Выбор голоса (Alena, Filipp, Jane, John, Masha, Omazh, Zahar) |\r\n| **Role** | Options | Эмоциональная окраска (Neutral, Good, Evil) |\r\n\r\n**Доступные голоса:**\r\n\r\n- **Alena** - женский, русский\r\n- **Filipp** - мужской, русский\r\n- **Jane** - женский, русский/английский\r\n- **John** - мужской, английский\r\n- **Masha** - женский, русский\r\n- **Omazh** - женский, русский\r\n- **Zahar** - мужской, русский\r\n\r\n**Форматы аудио:**\r\n\r\n*Container (файлы в контейнере):*\r\n\r\n- **WAV** - несжатый формат\r\n- **MP3** - сжатый с потерями\r\n- **OGG Opus** - открытый кодек\r\n\r\n*Raw PCM (сырой аудиопоток):*\r\n\r\n- Частоты дискретизации: 8000, 16000, 22050, 48000 Hz\r\n- Кодировка: LINEAR16_PCM\r\n\r\n**Дополнительные опции:**\r\n\r\n- **Speed** - скорость речи (0.1 - 3.0, по умолчанию 1.0)\r\n- **Volume** - громкость (-145 до 1)\r\n- **Pitch Shift** - изменение тона голоса (-1000 до 1000 Hz)\r\n\r\n**Процесс синтеза:**\r\n\r\n1. Парсинг service account credentials\r\n2. Создание SDK сессии\r\n3. Подключение к TTS API (`tts.api.cloud.yandex.net:443`)\r\n4. Потоковая генерация аудио chunks\r\n5. Объединение chunks в итоговый файл\r\n6. Подготовка бинарных данных с правильным MIME-типом\r\n\r\n**Возвращаемые данные:**\r\n\r\n- `success` - статус синтеза\r\n- `text` - исходный текст\r\n- `voice` - использованный голос\r\n- `role` - эмоциональная роль\r\n- `audioFormat` - формат аудио\r\n- `audioSize` - размер файла в байтах\r\n- Binary data - аудиофайл с расширением .wav/.mp3/.ogg/.raw\r\n\r\n**Аутентификация:** Service account JSON через `yandexCloudAuthorizedApi` с автоматической генерацией IAM-токенов. Использует gRPC streaming для эффективной передачи аудио. Нода идеально подходит для создания голосовых помощников, озвучивания уведомлений, генерации аудиокниг, accessibility-решений, IVR-систем и любых приложений, требующих преобразования текста в естественную речь на русском и английском языках.\r\n\r\n---\r\n\r\n## Yandex Cloud SpeechKit STT\r\n\r\n**Нода для распознавания речи (Speech-to-Text) с использованием Yandex SpeechKit API v3, обеспечивающая асинхронную транскрибацию аудио с высокой точностью.** Поддерживает множество языков и аудиоформатов с возможностью автоматического определения языка.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Operation** | Options | Recognize Audio или Get Recognition Results |\r\n| **Audio URL** | String | URL аудиофайла в Yandex Object Storage |\r\n| **Language Code** | Options | Язык распознавания (авто-определение, русский, английский и др.) |\r\n| **Format Specification** | Options | Выбор способа указания формата: коды Audio Format или MIME Types |\r\n| **Audio Format** | Options | Формат аудио Yandex Cloud (LPCM, OGG Opus, MP3) - отображается при выборе \"Audio Format\" |\r\n| **MIME Type** | Options | Стандартный MIME тип (audio/wav, audio/ogg, audio/mpeg и др.) - отображается при выборе \"MIME Type\" |\r\n\r\n**Операции:**\r\n\r\n- **Recognize Audio** - запуск асинхронной транскрибации аудио\r\n  - Возвращает operation ID для опроса результатов\r\n  - Поддерживает аудиофайлы в Yandex Object Storage\r\n  \r\n- **Get Recognition Results** - получение результатов транскрибации с авто-опросом\r\n  - Автоматический опрос до завершения\r\n  - Обработка race condition \"operation not ready\"\r\n  - Настраиваемый интервал опроса и макс. попыток\r\n  - Опциональные частичные результаты при таймауте\r\n\r\n**Поддерживаемые языки:**\r\n\r\n- Автоматическое определение\r\n- Русский (ru-RU)\r\n- Английский (en-US)\r\n- Немецкий (de-DE)\r\n- Французский (fr-FR)\r\n- Испанский (es-ES)\r\n- Итальянский (it-IT)\r\n- Польский (pl-PL)\r\n- Турецкий (tr-TR)\r\n- И многие другие (всего 16 языков)\r\n\r\n**Форматы аудио:**\r\n\r\nНода поддерживает два способа указания формата аудио:\r\n\r\n*Через Audio Format (коды форматов Yandex Cloud):*\r\n\r\n- **LPCM** - Linear PCM с настраиваемой частотой дискретизации (8000, 16000, 48000 Гц)\r\n- **OGG Opus** - Сжатый формат Ogg Opus\r\n- **MP3** - Стандартный формат MP3\r\n\r\n*Через MIME Type (стандартные MIME типы, автоматически преобразуются в форматы Yandex):*\r\n\r\n- **audio/wav, audio/pcm, audio/x-pcm** - Преобразуется в LPCM\r\n- **audio/ogg, audio/opus** - Преобразуется в OGG Opus\r\n- **audio/mpeg, audio/mp3** - Преобразуется в MP3\r\n\r\n**Опции распознавания:**\r\n\r\n- **Audio Channel Count** - количество аудиоканалов (1-8)\r\n- **Sample Rate** - для формата LPCM (8000, 16000, 48000 Гц)\r\n- **Profanity Filter** - фильтрация нецензурной лексики\r\n- **Literature Text** - использование литературной нормализации текста\r\n\r\n**Опции опроса (Get Results):**\r\n\r\n- **Poll Interval** - время между попытками опроса (1-60 секунд, по умолчанию 5)\r\n- **Max Attempts** - максимальное количество попыток опроса (1-300, по умолчанию 60)\r\n- **Return Partial Results** - возврат неполных результатов при таймауте\r\n\r\n**Процесс распознавания:**\r\n\r\n1. Загрузка аудиофайла в Yandex Object Storage\r\n2. Запуск распознавания с URL аудио и параметрами\r\n3. Получение operation ID\r\n4. Опрос результатов (авто-повтор при ошибках \"not ready\")\r\n5. Получение распознанного текста с оценками достоверности\r\n\r\n**Возвращаемые данные (Recognize):**\r\n\r\n- `success` - статус запуска операции\r\n- `operationId` - ID для опроса результатов\r\n- `audioUrl` - URL аудиофайла\r\n- `model` - использованная модель распознавания (general)\r\n- `languageCode` - выбранный язык\r\n- `status` - статус операции (RUNNING)\r\n\r\n**Возвращаемые данные (Get Results):**\r\n\r\n- `success` - статус завершения\r\n- `operationId` - ID операции\r\n- `status` - DONE или RUNNING\r\n- `text` - полный распознанный текст\r\n- `channelTag` - идентификатор аудиоканала\r\n- `finalResults` - детальные результаты с альтернативами\r\n- `attemptsUsed` - количество использованных попыток опроса\r\n\r\n**Аутентификация:** Service account JSON через `yandexCloudAuthorizedApi` с автоматической генерацией IAM-токенов. Использует gRPC streaming для эффективной передачи данных. Автоматически обрабатывает race condition, когда данные операции не сразу доступны. Нода идеально подходит для создания голосовых интерфейсов, транскрибации встреч, аналитики call-центров, генерации субтитров, accessibility-функций и любых приложений, требующих точного преобразования речи в текст на множестве языков с поддержкой асинхронной обработки.\r\n\r\n---\r\n\r\n## Yandex Cloud Translate\r\n\r\n**Нода для перевода текста с использованием Yandex Cloud Translate API, предоставляющая высококачественный нейронный машинный перевод для более чем 100 языков.** Поддерживает автоматическое определение языка, пользовательские глоссарии, перевод HTML и проверку орфографии перед переводом.\r\n\r\n|| Параметр | Тип | Описание |\r\n||----------|-----|----------|\r\n|| **Resource** | Options | Text или Language |\r\n|| **Operation** | Options | Translate, Detect Language или List |\r\n|| **Folder ID** | String | ID папки (по умолчанию из credentials) |\r\n\r\n**Ресурсы и операции:**\r\n\r\n- **Text** - перевод текста и определение языка\r\n  - **Translate** - перевод текста на целевой язык с опциональным глоссарием\r\n  - **Detect Language** - автоматическое определение языка текста\r\n- **Language** - управление поддерживаемыми языками\r\n  - **List** - получение всех поддерживаемых языков\r\n\r\n**Параметры перевода:**\r\n\r\n- `texts` - текст для перевода (многострочный, поддерживает несколько текстов через перевод строки)\r\n- `sourceLanguageCode` - исходный язык (оставьте пустым для автоопределения)\r\n- `targetLanguageCode` - целевой язык (обязательный)\r\n- `format` - формат текста (Plain Text или HTML)\r\n- `speller` - включить проверку орфографии перед переводом\r\n- `model` - ID пользовательской модели перевода (опционально)\r\n- `glossary` - пользовательские термины глоссария для точного перевода\r\n\r\n**Конфигурация глоссария:**\r\n\r\nСловарь пользовательских терминов для точного перевода специфических терминов:\r\n\r\n- `sourceText` - термин на исходном языке\r\n- `translatedText` - термин на целевом языке\r\n- `exact` - использовать точное совпадение слов\r\n\r\n**Определение языка:**\r\n\r\n- `text` - текст для определения языка\r\n- `languageCodeHints` - коды языков через запятую для приоритизации (например, en,ru,es)\r\n\r\n**Поддерживаемые языки:**\r\n\r\nБолее 100 языков, включая: русский, английский, немецкий, французский, испанский, итальянский, португальский, польский, турецкий, китайский, японский, корейский, арабский, иврит, хинди и многие другие. Полный список доступен через операцию List Languages.\r\n\r\n**Ограничения API:**\r\n\r\n- Максимум 10,000 символов на запрос\r\n- Несколько текстов можно переводить в одном запросе\r\n- Поддерживается пакетный перевод через ввод с разделением строками\r\n\r\n**Возвращаемые данные (Translate):**\r\n\r\n- `success` - статус перевода\r\n- `sourceLanguageCode` - исходный язык (авто-определен, если не указан)\r\n- `targetLanguageCode` - целевой язык\r\n- `translations` - массив результатов перевода\r\n  - `text` - переведенный текст\r\n  - `detectedLanguageCode` - определенный исходный язык\r\n\r\n**Возвращаемые данные (Detect Language):**\r\n\r\n- `success` - статус определения\r\n- `text` - анализируемый текст\r\n- `languageCode` - определенный код языка\r\n\r\n**Возвращаемые данные (List Languages):**\r\n\r\n- Массив поддерживаемых языков с:\r\n  - `code` - код языка (ISO 639-1)\r\n  - `name` - название языка\r\n\r\n**Сценарии использования:**\r\n\r\n- Локализация многоязычного контента\r\n- Перевод чата в реальном времени\r\n- Рабочие процессы перевода документов\r\n- Перевод пользовательского контента\r\n- Поддержка клиентов на нескольких языках\r\n- Локализация ответов API\r\n- Перевод email и уведомлений\r\n- Перевод содержимого веб-сайтов\r\n\r\n**Аутентификация:** Service account JSON через `yandexCloudAuthorizedApi` с автоматической генерацией IAM-токенов. Использует Yandex Cloud Translate API v2 с gRPC протоколом для эффективной коммуникации. Нода идеально подходит для создания многоязычных приложений, автоматизации перевода контента, создания pipeline'ов перевода и интеграции машинного перевода в бизнес-процессы с поддержкой пользовательской терминологии и сохранением HTML-контента.\r\n\r\n---\r\n\r\n## Yandex Cloud Workflows\r\n\r\n**Нода для запуска выполнения рабочих процессов в Yandex Cloud Workflows, serverless-сервисе для оркестрации облачных ресурсов и микросервисов.** Позволяет интегрировать n8n workflows с Yandex Workflows, создавая гибридные автоматизации.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Resource** | Options | Workflow |\r\n| **Operation** | Options | Start Execution |\r\n| **Folder ID** | String | ID папки с workflows |\r\n| **Workflow** | Options | Выбор workflow из списка или указание ID |\r\n| **Input Data** | String (JSON) | Входные данные для workflow в формате JSON |\r\n\r\n**Процесс запуска:**\r\n\r\n1. Загрузка списка доступных workflows из указанной папки\r\n2. Валидация входных данных (проверка корректности JSON)\r\n3. Создание SDK клиента ExecutionServiceClient\r\n4. Отправка запроса на запуск выполнения с указанием:\r\n   - `workflowId` - ID рабочего процесса\r\n   - `input.inputJson` - JSON-строка с входными параметрами\r\n5. Получение execution ID\r\n\r\n**Возвращаемые данные:**\r\n\r\n- `executionId` - уникальный ID запущенного выполнения\r\n- `workflowId` - ID workflow\r\n- `success` - статус запуска\r\n\r\n**Примеры использования:**\r\n\r\n- Запуск сложной оркестрации облачных функций из n8n\r\n- Передача данных между n8n и Yandex Workflows\r\n- Триггер long-running процессов\r\n- Интеграция с существующими Workflows definitions\r\n\r\n**Аутентификация:** Service account JSON через `yandexCloudAuthorizedApi` для создания SDK сессии. Автоматически валидирует JSON перед отправкой. Поддерживает resource locator для удобного выбора workflows с отображением описания. Нода подходит для создания комплексных автоматизаций, где n8n управляет внешними интеграциями и API, а Yandex Workflows координирует облачные ресурсы (Functions, Containers, Compute), обеспечивая визуальное проектирование сложных бизнес-процессов с обработкой ошибок, retry-логикой и параллельным выполнением задач.\r\n\r\n## Yandex Cloud YDB\r\n\r\n**Нода для работы с Yandex Database (YDB) — распределённой SQL-базой данных с автоматическим горизонтальным масштабированием и высокой доступностью.** Предоставляет возможность выполнения YQL (Yandex Query Language) запросов с привязкой параметров, автоматическим преобразованием типов и поддержкой множественных наборов результатов.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Resource** | Options | Query |\r\n| **Operation** | Options | Execute или Execute with Parameters |\r\n| **YQL Query** | String | YQL запрос для выполнения |\r\n| **Return Mode** | Options | All Result Sets, First Result Set или First Row Only |\r\n\r\n**Операции:**\r\n\r\n- **Execute** — выполнить простой YQL запрос без параметров\r\n- **Execute with Parameters** — выполнить параметризованный запрос с безопасной привязкой параметров\r\n\r\n**Параметры запроса (для Execute with Parameters):**\r\n\r\nКоллекция параметров запроса с настройкой:\r\n\r\n- `name` — имя параметра (без префикса $)\r\n- `value` — значение параметра (автоматически конвертируется в соответствующий тип YDB)\r\n\r\n**Режимы возврата данных:**\r\n\r\n- **All Result Sets** — возвращает все наборы результатов из мультизапросов\r\n  - Возвращает: `resultSets` (массив наборов), `resultSetCount`, `totalRows`\r\n- **First Result Set** — возвращает только первый набор результатов в виде массива\r\n  - Возвращает: `rows` (массив строк), `rowCount`\r\n- **First Row Only** — возвращает только первую строку первого набора результатов\r\n  - Возвращает: единственный объект или null\r\n\r\n**Преобразование типов:**\r\n\r\nАвтоматическое двунаправленное преобразование между типами JavaScript и YDB:\r\n\r\n| JavaScript | Тип YDB | Пример |\r\n|-----------|----------|---------|\r\n| string | Text/String | \"hello\" → Text |\r\n| number (int) | Int32 | 42 → Int32 |\r\n| number (float) | Double | 3.14 → Double |\r\n| bigint | Int64 | 9007199254740991n → Int64 |\r\n| boolean | Bool | true → Bool |\r\n| Date | Datetime | new Date() → Datetime |\r\n| Array | List | [1,2,3] → List<Int32> |\r\n| Object | Struct | {a:1} → Struct<a:Int32> |\r\n| null | Null/Optional | null → Optional |\r\n\r\n**Примеры запросов:**\r\n\r\n*Простой запрос:*\r\n\r\n```sql\r\nSELECT id, name, email FROM users WHERE active = true LIMIT 10\r\n```\r\n\r\n*Параметризованный запрос:*\r\n\r\n```sql\r\nSELECT * FROM orders WHERE user_id = $userId AND order_date >= $startDate\r\n```\r\n\r\nПараметры: `userId` = 12345, `startDate` = \"2025-01-01\"\r\n\r\n*Пакетная вставка:*\r\n\r\n```sql\r\nUPSERT INTO products SELECT * FROM AS_TABLE($rows)\r\n```\r\n\r\nПараметры: `rows` = массив объектов продуктов\r\n\r\n*Множественные наборы результатов:*\r\n\r\n```sql\r\nSELECT COUNT(*) as total_users FROM users;\r\nSELECT COUNT(*) as total_orders FROM orders;\r\nSELECT COUNT(*) as total_products FROM products;\r\n```\r\n\r\n**Аутентификация:**\r\n\r\nНода YDB использует подход с двойными credentials для улучшенной безопасности и гибкости:\r\n\r\n1. **Yandex Cloud Authorized API** (Обязательно)\r\n   - Предоставляет Service Account JSON для аутентификации\r\n   - Используется совместно с несколькими сервисами Yandex Cloud\r\n   - Генерирует IAM-токены для безопасного доступа\r\n\r\n2. **Yandex Cloud YDB API** (Обязательно)\r\n   - Предоставляет параметры подключения к YDB (Endpoint и Database)\r\n   - Отделяет параметры подключения от аутентификации\r\n   - Позволяет легко переключаться между базами данных (dev/staging/prod)\r\n   - Переиспользуется между нодами с одной базой данных\r\n\r\nТакое разделение позволяет использовать один service account с несколькими базами данных YDB, сохраняя четкие границы безопасности.\r\n\r\n**Процесс выполнения:**\r\n\r\n1. Парсинг credentials service account JSON\r\n2. Генерация IAM токена через Yandex Cloud IAM сервис\r\n3. Создание YDB драйвера с аутентификацией\r\n4. Конвертация JavaScript параметров в типы YDB используя @ydbjs/value\r\n5. Выполнение YQL запроса через @ydbjs/query\r\n6. Конвертация наборов результатов YDB обратно в JavaScript объекты\r\n7. Возврат данных согласно выбранному режиму\r\n8. Закрытие соединения драйвера\r\n\r\n**Возвращаемые данные:**\r\n\r\nЗависит от режима возврата:\r\n\r\n- **All Result Sets**: `{resultSets: [[...], [...]], resultSetCount: 2, totalRows: 15}`\r\n- **First Result Set**: `{rows: [{id: 1, name: \"Alice\"}, ...], rowCount: 10}`\r\n- **First Row Only**: `{id: 1, name: \"Alice\", email: \"alice@example.com\"}` или `null`\r\n\r\n**Варианты использования:**\r\n\r\n- Аналитические запросы в реальном времени\r\n- Агрегация данных и отчётность\r\n- Управление пользовательскими данными (CRUD операции)\r\n- Сложные соединения и трансформации\r\n- ETL-процессы со структурированными данными\r\n- Слой данных для микросервисов\r\n- Event sourcing и журналы аудита\r\n- Мультитенантные SaaS базы данных\r\n- Транзакционные нагрузки с сильной согласованностью\r\n\r\n**Лучшие практики:**\r\n\r\n- Всегда используйте параметризованные запросы для динамических значений (предотвращает SQL инъекции)\r\n- Используйте AS_TABLE для пакетных операций (эффективнее индивидуальных вставок)\r\n- Используйте индексы YDB для лучшей производительности запросов\r\n- Мониторьте статистику запросов через возвращаемые данные\r\n- Обрабатывайте ошибки корректно с режимом Continue on Fail\r\n- Рассмотрите использование First Row Only для агрегатов и подсчётов\r\n- Используйте YDB-специфичные функции как UPSERT для идемпотентных операций\r\n\r\n**Использование:** Требует оба credentials: `yandexCloudAuthorizedApi` (аутентификация service account) и `yandexCloudYdbApi` (параметры подключения). Использует Yandex Cloud IAM для генерации токенов и @ydbjs SDK для подключения к базе данных. Нода идеальна для создания data-driven приложений, аналитических дашбордов, систем управления пользователями и любых сценариев, требующих распределённую SQL базу данных с горизонтальным масштабированием, сильной согласованностью и встроенной репликацией в n8n workflow.\r\n\r\n---\r\n\r\n## Yandex Cloud Search\r\n\r\n**Нода для работы с Yandex Cloud Search API, предоставляющая возможности веб-поиска и AI-генеративного поиска.** Использует официальный Yandex Cloud SDK для доступа к поисковым сервисам с поддержкой потоковой передачи для генеративных ответов и автоматическим парсингом XML для результатов веб-поиска.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Operation** | Options | Веб-поиск или Генеративный поиск |\r\n| **Folder ID** | String | ID каталога (по умолчанию из credentials) |\r\n\r\n**Операции:**\r\n\r\n### Веб-поиск (Web Search)\r\n\r\nВыполнение традиционных веб-поисковых запросов с обширными возможностями фильтрации и настройки.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Query** | String | Текст поискового запроса (обязательно) |\r\n| **Search Type** | Options | RU, TR, COM, KK, BY, UZ (по умолчанию: RU) |\r\n\r\n**Дополнительные опции:**\r\n\r\n- **Family Mode** - Фильтрация контента (None, Moderate, Strict)\r\n- **Page Number** - Страница результатов (от 0, по умолчанию: 0)\r\n- **Fix Typos** - Автоисправление опечаток (Auto, Disabled)\r\n- **Sort By** - Сортировка по релевантности или времени\r\n- **Sort Order** - По возрастанию или убыванию (для сортировки по времени)\r\n- **Group By** - Плоская группировка или по домену\r\n- **Groups on Page** - Количество групп на странице (по умолчанию: 10)\r\n- **Docs in Group** - Документов в группе (по умолчанию: 1)\r\n- **Max Passages** - Максимум пассажей в сниппете (по умолчанию: 2)\r\n- **Region** - ID региона поиска (например, 213 для Москвы)\r\n- **Localization** - Язык интерфейса (RU, UK, BE, KK, TR, EN)\r\n- **Response Format** - XML или HTML (по умолчанию: XML)\r\n- **Parse XML to JSON** - Автоматически парсить XML ответ (по умолчанию: true)\r\n\r\n**Возвращает:**\r\n\r\n- `rawData` - Сырой XML/HTML ответ от поискового API\r\n- `parsedData` - Распарсенная JSON структура (когда parseXml включён)\r\n- `parseError` - Сообщение об ошибке, если парсинг XML не удался\r\n\r\n### Генеративный поиск (Generative Search)\r\n\r\nAI-поиск с генерацией естественноязыковых ответов на основе результатов поиска.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Messages** | Collection | Сообщения диалога с ролью (User/Assistant) и контентом |\r\n\r\n**Дополнительные опции:**\r\n\r\n- **Search Type** - RU, TR, COM, KK, BY, UZ\r\n- **Site Restriction** - Ограничить поиск конкретным сайтом (например, example.com)\r\n- **Host Restriction** - Ограничить конкретным хостом (например, <www.example.com>)\r\n- **URL Restriction** - Ограничить конкретным URL путём\r\n- **Fix Misspell** - Автоматически исправлять опечатки в запросе\r\n- **Enable NRFM Docs** - Включить документы не с главной страницы\r\n- **Get Partial Results** - Стримить частичные результаты во время обработки\r\n\r\n**Возвращает:**\r\n\r\n- `responses` - Массив всех полученных потоковых ответов\r\n- `finalResponse` - Последний ответ с полным результатом\r\n  - `message` - Текст сгенерированного ответа\r\n  - `sources` - Массив использованных источников (url, title, used флаг)\r\n  - `searchQueries` - Уточнённые запросы, использованные для генерации\r\n  - `fixedMisspellQuery` - Исправленный запрос, если были опечатки\r\n  - `isAnswerRejected` - Был ли ответ отклонён по этическим причинам\r\n  - `isBulletAnswer` - Ответ в формате маркированного списка\r\n\r\n**Пример диалога:**\r\n\r\n```json\r\n{\r\n  \"messages\": [\r\n    { \"role\": \"USER\", \"content\": \"Что такое n8n?\" },\r\n    { \"role\": \"ASSISTANT\", \"content\": \"n8n это инструмент автоматизации workflow...\" },\r\n    { \"role\": \"USER\", \"content\": \"Как его установить?\" }\r\n  ]\r\n}\r\n```\r\n\r\n**Процесс выполнения:**\r\n\r\n1. Парсинг JSON credentials service account с валидацией\r\n2. Создание аутентифицированной SDK сессии\r\n3. Выполнение операции поиска через соответствующий service client\r\n4. Для веб-поиска: парсинг XML ответа в JSON (если включено)\r\n5. Для генеративного поиска: накопление потоковых ответов\r\n6. Возврат структурированных результатов с pairedItem ссылками\r\n\r\n**Ключевые возможности:**\r\n\r\n- **Поддержка стриминга** - Генеративный поиск использует потоковую передачу на стороне сервера для прогрессивных результатов\r\n- **Парсинг XML** - Автоматическая конвертация XML ответов в JSON для упрощения обработки\r\n- **Многосообщенческий контекст** - Поддержка диалогового поиска с историей\r\n- **Гибкая фильтрация** - Обширные опции для уточнения результатов поиска\r\n- **Атрибуция источников** - Отслеживание использованных источников в генеративных ответах\r\n- **Устойчивость к ошибкам** - Корректная обработка ошибок с поддержкой Continue on Fail\r\n\r\n**Аутентификация:** Использует service account JSON через credentials `yandexCloudAuthorizedApi`. Валидирует все обязательные поля credentials (serviceAccountId, accessKeyId, privateKey) и folder ID. Поддерживает переопределение folder ID на уровне ноды. Нода идеальна для создания поисковых приложений, исследовательских инструментов, систем обнаружения контента, AI-ассистентов с веб-знаниями и любых сценариев, требующих интеграцию поиска с настраиваемой релевантностью и фильтрацией в n8n workflow.\r\n\r\n---\r\n\r\n## Yandex Cloud Vision OCR\r\n\r\n**Нода для распознавания текста на изображениях с использованием Yandex Cloud Vision OCR API, обеспечивающая высокоточное оптическое распознавание символов с поддержкой множества языков и форматов.** Поддерживает файлы JPEG, PNG и PDF с автоматическим определением MIME-типа и гибким форматированием вывода.\r\n\r\n| Параметр | Тип | Описание |\r\n|----------|-----|----------|\r\n| **Resource** | Options | Text Recognition (Распознавание текста) |\r\n| **Operation** | Options | Recognize (Распознать) |\r\n| **Binary Property** | String | Имя бинарного свойства с данными изображения (по умолчанию: \"data\") |\r\n| **MIME Type** | Options | Автоопределение, JPEG, PNG или PDF |\r\n| **Languages** | Multi-options | Языки для распознавания (формат ISO 639-1) |\r\n| **Model** | Options | Выбор модели OCR (Page, Table, Markdown, Math Markdown) |\r\n| **Output Format** | Options | Только полный текст, структурированные данные или оба варианта |\r\n\r\n**Поддерживаемые языки:**\r\n\r\nOCR поддерживает более 50 языков, организованных в две модели:\r\n\r\n*Латино-кириллическая модель:*\r\n\r\n- Английский, Русский, Немецкий, Французский, Испанский, Итальянский, Португальский, Голландский, Польский\r\n- Чешский, Словацкий, Болгарский, Сербский, Боснийский, Румынский, Венгерский\r\n- Шведский, Норвежский, Датский, Финский, Эстонский, Латышский, Литовский\r\n- Турецкий, Азербайджанский, Казахский, Узбекский, Таджикский, Киргизский, Татарский, Башкирский, Якутский, Чувашский\r\n- Индонезийский, Мальтийский, Словенский\r\n\r\n*Другие модели (с поддержкой русского и английского):*\r\n\r\n- Арабский, Китайский, Японский, Корейский, Тайский, Вьетнамский\r\n- Иврит, Греческий, Армянский, Грузинский\r\n\r\nВсе языки используют коды формата ISO 639-1 (например, 'en', 'ru', 'de')\r\n\r\n**Модели OCR:**\r\n\r\n*Модели общего распознавания текста:*\r\n\r\n- **Page** - Универсальное распознавание текста для документов и изображений (по умолчанию)\r\n- **Page Column Sort** - Распознавание многоколоночного текста\r\n- **Handwritten** - Оптимизировано для распознавания рукописного текста\r\n- **Table** - Оптимизировано для распознавания табличных данных и структурированных макетов\r\n- **Markdown** - Возвращает распознанный текст в формате markdown\r\n- **Math Markdown** - Специализировано для математических формул и уравнений в markdown\r\n\r\n*Модели распознавания шаблонных документов:*\r\n\r\n- **Passport** - Шаблонное распознавание паспортов\r\n- **Driver License Front** - Шаблонное распознавание водительского удостоверения (лицевая сторона)\r\n- **Driver License Back** - Шаблонное распознавание водительского удостоверения (обратная сторона)\r\n- **Vehicle Registration Front** - Шаблонное распознавание свидетельства о регистрации ТС (лицевая сторона)\r\n- **Vehicle Registration Back** - Шаблонное распознавание свидетельства о регистрации ТС (обратная сторона)\r\n- **License Plates** - Распознавание регистрационных номеров автомобилей\r\n\r\n**Поддержка форматов файлов:**\r\n\r\n- **JPEG** - Стандартные JPEG изображения\r\n- **PNG** - PNG изображения с поддержкой прозрачности\r\n- **PDF** - Одностраничные PDF документы\r\n- Максимальный размер файла: 10МБ\r\n- Максимальные размеры изображения: 20М пикселей (ширина × высота)\r\n\r\n**Форматы вывода:**\r\n\r\n1. **Только полный текст** - Простая строка со всем распознанным текстом\r\n   - Возвращает: `{ fullText: \"распознанный текст...\" }`\r\n\r\n2. **Структурированные данные** - Детальная структура с координатами и метаданными\r\n   - Возвращает: `{ structured: [{ page, width, height, blocks, entities, tables, markdown, pictures }] }`\r\n   - Включает ограничивающие рамки для блоков, строк и слов\r\n   - Предоставляет распознавание ячеек таблиц с индексами строк/столбцов\r\n   - Определяет сущности и картинки с оценками достоверности\r\n\r\n3. **Оба** - Комбинированный вывод с полным текстом и структурированными данными\r\n   - Возвращает: `{ fullText: \"...\", structured: [...] }`\r\n\r\n**Процесс распознавания:**\r\n\r\n1. Получение данных изображения из указанного бинарного свойства\r\n2. Автоопределение или использование указанного MIME-типа\r\n3. Валидация размера файла (макс. 10МБ)\r\n4. Валидация требований модели (напр., license-plates требует явного указания языка)\r\n5. Отправка запроса на распознавание с предпочтениями языка и выбором модели\r\n6. Потоковая передача фрагментов ответа от OCR API\r\n7. Объединение результатов для многостраничных PDF\r\n8. Форматирование вывода согласно выбранному формату\r\n\r\n**Возвращаемые данные (полный текст):**\r\n\r\n- `fullText` - Полный распознанный текст со всех страниц\r\n\r\n**Возвращаемые данные (структурированные):**\r\n\r\n- `structured` - Массив аннотаций страниц\r\n  - `page` - Номер страницы (начиная с 1)\r\n  - `width` / `height` - Размеры изображения в пикселях\r\n  - `blocks` - Текстовые блоки с ограничивающими рамками, строками, словами, языками\r\n  - `entities` - Именованные сущности, обнаруженные в тексте\r\n  - `tables` - Распознанные таблицы с данными ячеек (индексы строк/столбцов, объединения, текст)\r\n  - `markdown` - Текст в формате markdown (если модель поддерживает)\r\n  - `pictures` - Обнаруженные местоположения картинок с оценками достоверности\r\n  - `rotate` - Угол поворота изображения (ANGLE_0, ANGLE_90, ANGLE_180, ANGLE_270)\r\n\r\n**Детали структурированных данных:**\r\n\r\n*Структура блока:*\r\n\r\n- `boundingBox` - Вершины полигона, определяющего область блока\r\n- `lines` - Массив текстовых строк со словами и ориентацией\r\n- `languages` - Обнаруженные языки в блоке\r\n- `layoutType` - Тип блока (TEXT, HEADER, FOOTER, TITLE, LIST и т.д.)\r\n\r\n*Структура таблицы:*\r\n\r\n- `rowCount` / `columnCount` - Размерность таблицы\r\n- `cells` - Массив ячеек таблицы с:\r\n  - `rowIndex` / `columnIndex` - Позиция ячейки\r\n  - `rowSpan` / `columnSpan` - Объединение ячеек\r\n  - `text` - Содержимое ячейки\r\n\r\n**Сценарии использования:**\r\n\r\n- Оцифровка и архивирование документов\r\n- Обработка счетов и чеков\r\n- Извлечение данных из удостоверений личности и паспортов\r\n- Извлечение табличных данных из изображений\r\n- Извлечение текста из отсканированных документов\r\n- Обработка многоязычных документов\r\n- Автоматизация обработки форм\r\n- OCR для функций доступности\r\n- Модерация контента с определением текста\r\n- Распознавание номерных знаков (со структурированными координатами)\r\n\r\n**Определение MIME-типа:**\r\n\r\nНода автоматически определяет формат изображения, анализируя магические байты:\r\n\r\n- JPEG: заголовок `FF D8 FF`\r\n- PNG: заголовок `89 50 4E 47`\r\n- PDF: заголовок `25 50 44 46`\r\n- По умолчанию использует JPEG, если определение не удалось\r\n\r\n**Обработка ошибок:**\r\n\r\n- Валидирует наличие и размер бинарных данных\r\n- Проверяет лимит размера файла (10МБ)\r\n- Валидирует требования конкретных моделей (напр., license-plates требует явного указания языка)\r\n- Валидирует учетные данные сервисного аккаунта\r\n- Поддерживает режим Continue on Fail для пакетной обработки\r\n- Возвращает подробные сообщения об ошибках с контекстом\r\n\r\n**Поддержка многостраничных PDF:**\r\n\r\nДля PDF файлов с несколькими страницами нода:\r\n\r\n- Обрабатывает каждую страницу отдельно\r\n- Объединяет полный текст с разделителями в виде двойного переноса строки\r\n- Возвращает массив структурированных данных с номерами страниц\r\n- Сохраняет метаданные и координаты для каждой страницы\r\n\r\n**Аутентификация:** Использует service account JSON через credentials `yandexCloudAuthorizedApi` с автоматической генерацией IAM токена. Использует gRPC потоковую передачу для эффективной передачи данных. Подключается к `ocr.api.cloud.yandex.net:443` для запросов распознавания. Нода идеальна для создания workflow обработки документов, конвейеров извлечения данных, автоматизации форм, систем обработки счетов и любых приложений, требующих точного распознавания текста из изображений с поддержкой сложных макетов, таблиц и математических обозначений в n8n workflow.\r\n\r\n---\r\n\r\n## Yandex Cloud Logging\r\n\r\n**Нода для централизованного управления логами с помощью сервиса Yandex Cloud Logging, предоставляющая операции записи и чтения логов.** Поддерживает структурированное логирование с JSON-данными, фильтрацию по времени и организацию по ресурсам с автоматической пагинацией и пакетными операциями.\r\n\r\n| Параметр | Тип | Ресурсы | Операции |\r\n|----------|-----|---------|----------|\r\n| **Log Entry** | Resource | Log Entry | Write, Read |\r\n\r\n**Операции с записями логов:**\r\n\r\n- **Write** - отправка записей в лог-группу с поддержкой:\r\n  - Множественных записей в одном запросе\r\n  - Уровней логирования (TRACE, DEBUG, INFO, WARN, ERROR, FATAL)\r\n  - Автоматических или пользовательских меток времени\r\n  - JSON-данных для структурированной информации\r\n  - Имён потоков для организации логов\r\n  - Метаданных ресурсов (тип и ID)\r\n  - Значений по умолчанию для уровня, данных и потока\r\n\r\n- **Read** - получение записей логов с фильтрацией:\r\n  - Фильтрация по временному диапазону (since/until)\r\n  - Фильтрация по уровням логирования (множественный выбор)\r\n  - Фильтрация по типу и ID ресурса\r\n  - Фильтрация по именам потоков\r\n  - Расширенные выражения фильтрации\r\n  - Автоматическая поддержка пагинации\r\n  - Возврат всех записей или с ограничением\r\n\r\n**Параметры записи:**\r\n\r\n- `logGroupId` - целевая лог-группа (resource locator с выпадающим списком)\r\n- `entries` - массив записей логов с:\r\n  - `message` - текст лог-сообщения (обязательно)\r\n  - `level` - уровень логирования (TRACE/DEBUG/INFO/WARN/ERROR/FATAL)\r\n  - `timestamp` - формат ISO 8601 или автоматическая генерация\r\n  - `jsonPayload` - структурированные данные как JSON-объект\r\n  - `streamName` - поток для организации логов\r\n- `resourceType` / `resourceId` - опциональные метаданные ресурса\r\n- `defaults` - уровень, данные и поток по умолчанию для всех записей\r\n\r\n**Параметры чтения:**\r\n\r\n- `logGroupId` - исходная лог-группа (resource locator)\r\n- `returnAll` - получить все страницы или ограничить результаты\r\n- `limit` - максимальное количество записей (1-1000)\r\n- `filters` - опциональная фильтрация:\r\n  - `since` / `until` - временной диапазон (ISO 8601)\r\n  - `levels` - уровни логирования для включения\r\n  - `resourceTypes` - список типов ресурсов через запятую\r\n  - `resourceIds` - список ID ресурсов через запятую\r\n  - `streamNames` - список имён потоков через запятую\r\n  - `filter` - расширенное выражение фильтрации\r\n\r\n**Возвращаемые данные (Write):**\r\n\r\n- `success` - статус операции\r\n- `entriesWritten` - количество записанных записей\r\n- `logGroupId` - ID целевой лог-группы\r\n- `errors` - карта ошибок на уровне записей\r\n\r\n**Возвращаемые данные (Read):**\r\n\r\nКаждая запись лога возвращается как отдельный элемент с:\r\n\r\n- `uid` - уникальный ID записи\r\n- `message` - лог-сообщение\r\n- `level` - уровень логирования\r\n- `timestamp` - метка времени записи\r\n- `resource` - метаданные ресурса (type, id)\r\n- `jsonPayload` - структурированные данные\r\n- `streamName` - имя потока\r\n- `ingestedAt` - метка времени приёма\r\n- `savedAt` - метка времени сохранения\r\n\r\n**Сценарии использования:**\r\n\r\n- Централизованное логирование приложений\r\n- Мониторинг и оповещение об ошибках\r\n- Аудит и логирование для соответствия требованиям\r\n- Агрегация логов распределённых систем\r\n- Конвейеры анализа логов в реальном времени\r\n- Мониторинг производительности и метрик\r\n- Логирование событий безопасности\r\n- Устранение неполадок и отладка\r\n\r\n**Возможности:**\r\n\r\n- **Пакетная запись** - отправка множественных записей в одном запросе\r\n- **Структурированное логирование** - JSON-данные для богатой информации\r\n- **Фильтрация по времени** - точные запросы по временному диапазону\r\n- **Организация по ресурсам** - группировка логов по типу/ID ресурса\r\n- **Поддержка потоков** - организация логов по компонентам приложения\r\n- **Автоматическая пагинация** - обработка больших наборов результатов\r\n- **Resource Locator** - удобный выбор лог-группы из выпадающего списка\r\n\r\n**Аутентификация:** Использует service account JSON через credentials `yandexCloudAuthorizedApi` с автоматической генерацией IAM токена. Требуется роль `logging.writer` для записи логов и `logging.reader` для чтения логов. Нода идеальна для создания систем наблюдаемости, дашбордов мониторинга, workflow анализа логов, конвейеров оповещений и любых приложений, требующих централизованного структурированного логирования с мощными возможностями фильтрации и запросов в n8n workflow.\r\n\r\n---\r\n\r\n## Yandex Cloud YandexART\r\n\r\n**Нода для генерации изображений с помощью AI, используя API Yandex Cloud Foundation Models YandexART.** Создавайте высококачественные изображения из текстовых описаний с поддержкой негативных промптов, различных соотношений сторон и воспроизводимых результатов с помощью сидов. Включает обработку асинхронных операций с автоматическим опросом до завершения.\r\n\r\n| Параметр | Тип | Ресурсы | Операции |\r\n|----------|-----|---------|----------|\r\n| **Image** | Resource | Image | Generate |\r\n\r\n**Операции с изображениями:**\r\n\r\n- **Generate** - создание изображений из текстовых промптов с:\r\n  - Текстовым описанием (промпт) желаемого изображения\r\n  - Негативным промптом для указания нежелательных элементов\r\n  - Настраиваемым соотношением сторон (Квадрат, Альбомная 16:9, 21:9, Портретная 9:16, 9:21)\r\n  - Выбором формата вывода (JPEG, PNG)\r\n  - Опциональным сидом для воспроизводимой генерации\r\n  - Автоматическим опросом операции до завершения\r\n  - Возвратом сгенерированного изображения как бинарных данных\r\n\r\n**Параметры генерации:**\r\n\r\n- `prompt` - текстовое описание изображения для генерации (обязательно)\r\n- **Дополнительные опции:**\r\n  - `negativePrompt` - описание того, что нужно исключить из изображения (опционально)\r\n  - `mimeType` - формат вывода: JPEG или PNG (по умолчанию: JPEG)\r\n  - `aspectRatio` - пропорции изображения:\r\n    - Квадрат (1:1)\r\n    - Альбомная 16:9 (широкоэкранная)\r\n    - Альбомная 21:9 (ультраширокая)\r\n    - Портретная 9:16 (для мобильных)\r\n    - Портретная 9:21 (высокий формат)\r\n  - `seed` - числовой сид для воспроизводимости (опционально)\r\n- **Расширенные опции:**\r\n  - `waitForCompletion` - ожидать завершения генерации или вернуть ID операции (по умолчанию: true)\r\n  - `pollInterval` - миллисекунды между проверками статуса (по умолчанию: 2000)\r\n  - `maxWaitTime` - максимальное время ожидания в миллисекундах (по умолчанию: 300000 / 5 минут)\r\n\r\n**Возвращаемые данные (с ожиданием завершения):**\r\n\r\n- `success` - статус операции (true)\r\n- `operationId` - ID операции Yandex Cloud\r\n- `modelVersion` - версия модели YandexART\r\n- `prompt` - оригинальный текст промпта\r\n- `negativePrompt` - негативный промпт, если указан\r\n- `aspectRatio` - ключ соотношения сторон (например, \"SQUARE\")\r\n- `aspectRatioValues` - значения ширины и высоты соотношения\r\n- `mimeType` - MIME тип сгенерированного изображения\r\n- `seed` - использованный сид (число или \"auto\")\r\n- `imageSize` - размер изображения в байтах\r\n- `filename` - сгенерированное имя файла\r\n- `binary.data` - сгенерированное изображение как загружаемый файл\r\n\r\n**Возвращаемые данные (без ожидания):**\r\n\r\n- `success` - статус операции (true)\r\n- `operationId` - ID операции для ручной проверки статуса\r\n- `done` - статус завершения операции (false)\r\n- `message` - информационное сообщение\r\n- `prompt` - оригинальный текст промпта\r\n- `aspectRatio` - ключ соотношения сторон\r\n- `mimeType` - запрошенный MIME тип\r\n\r\n**Обработка асинхронных операций:**\r\n\r\nНода реализует автоматический опрос для асинхронных операций:\r\n\r\n1. Отправляет запрос на генерацию в API YandexART\r\n2. Получает ID операции\r\n3. Опрашивает статус операции каждые 2 секунды (настраивается)\r\n4. Продолжает опрос до завершения или таймаута\r\n5. Извлекает сгенерированное изображение из завершённой операции\r\n6. Возвращает изображение как бинарные данные с метаданными\r\n\r\nЕсли `waitForCompletion` равно false, немедленно возвращает ID операции для ручной проверки статуса.\r\n\r\n**Сценарии использования:**\r\n\r\n- Создание маркетингового контента (изображения продуктов, баннеры, рекламу)\r\n- Генерация визуального контента для социальных сетей\r\n- Иллюстрации и концепт-арт для блогов и статей\r\n- Прототипы макетов и дизайн-концепты\r\n- Визуализация образовательных материалов\r\n- Творческие workflow и художественные проекты\r\n- Автоматизированные конвейеры визуального контента\r\n- Генерация брендовых активов\r\n\r\n**Возможности:**\r\n\r\n- **Негативные промпты** - указание нежелательных элементов для лучшего контроля\r\n- **Контроль соотношения сторон** - оптимизация для разных платформ и сценариев\r\n- **Воспроизводимые результаты** - использование сидов для повторной генерации точных изображений\r\n- **Множество форматов** - вывод в JPEG или PNG\r\n- **Автоматический опрос** - бесшовная обработка асинхронных операций\r\n- **Бинарный вывод** - сгенерированные изображения готовы для загрузки или дальнейшей обработки\r\n- **Защита от таймаута** - настраиваемое максимальное время ожидания с понятными сообщениями об ошибках\r\n- **Гибкий workflow** - может возвращать ID операции для ручной проверки\r\n\r\n**Аутентификация:** Использует service account JSON через credentials `yandexCloudAuthorizedApi` с автоматической генерацией IAM токена. Требуется доступ к Foundation Models API в указанном каталоге. URI модели автоматически создаётся из ID каталога как `art://{folderId}/yandex-art/latest`. Нода идеальна для автоматизированного создания контента, маркетинговой автоматизации, творческих workflow и любых приложений, требующих AI-генерированного визуального контента, интегрированного в n8n workflow.\r\n\r\n---\r\n\r\n## Типы аутентификации\r\n\r\nВ пакете используются четыре типа credentials:\r\n\r\n### yandexCloudYdbApi\r\n\r\n- Endpoint (URL эндпоинта YDB)\r\n- Database (путь к базе данных YDB)\r\n- Используется для параметров подключения Yandex Cloud YDB (требует yandexCloudAuthorizedApi для аутентификации)\r\n\r\n### yandexCloudGptApi\r\n\r\n- API ключ для Foundation Models\r\n- Folder ID\r\n- URL эндпоинта (опционально)\r\n\r\n### yandexCloudStaticApi\r\n\r\n- Access Key ID\r\n- Secret Access Key\r\n- Используется для S3-совместимых сервисов (Object Storage, Data Streams, Message Queue, Postbox)\r\n\r\n### yandexCloudAuthorizedApi\r\n\r\n- Service Account JSON\r\n- Folder ID\r\n- Используется для сервисов, требующих IAM-токены (Functions, Containers, Compute, SpeechKit, Workflows, YDB)\r\n\r\n---\r\n\r\n## Yandex Cloud Lockbox\r\n\r\n**Нода для безопасного управления секретами с использованием сервиса Yandex Cloud Lockbox.** Храните и получайте конфиденциальные данные, такие как API-ключи, пароли, сертификаты и токены с контролем версий, шифрованием и гранулированным управлением доступом. Поддерживает как текстовые, так и бинарные секреты с автоматической аутентификацией через IAM-токены.\r\n\r\n| Параметр | Тип | Ресурсы | Операции |\r\n|----------|-----|---------|----------|\r\n| **Secret** | Ресурс | Secret | List, Get, Create, Update, Delete, Activate, Deactivate |\r\n| **Version** | Ресурс | Version | List, Add, Schedule Destruction, Cancel Destruction |\r\n| **Payload** | Ресурс | Payload | Get |\r\n\r\n**Операции с секретами:**\r\n\r\n- **List** - перечислить все секреты в каталоге с поддержкой пагинации\r\n- **Get** - получить метаданные секрета по ID (имя, описание, статус, метки, версии)\r\n- **Create** - создать новый секрет с начальной версией и записями payload\r\n  - Поддержка текстовых и бинарных значений (base64)\r\n  - Опциональная настройка ключа шифрования KMS\r\n  - Метки для организации и фильтрации\r\n  - Флаг защиты от удаления\r\n- **Update** - изменить метаданные секрета (имя, описание, метки, защита от удаления)\r\n- **Delete** - безвозвратно удалить секрет (учитывает защиту от удаления)\r\n- **Activate** - изменить статус секрета с INACTIVE на ACTIVE\r\n- **Deactivate** - изменить статус секрета с ACTIVE на INACTIVE\r\n\r\n**Операции с версиями:**\r\n\r\n- **List** - перечислить все версии конкретного секрета с пагинацией\r\n- **Add** - создать новую версию с обновлёнными записями payload\r\n  - Поддержка текстовых и бинарных значений\r\n  - Опциональная ссылка на базовую версию\r\n- **Schedule Destruction** - запланировать удаление версии с настраиваемым периодом ожидания (по умолчанию 7 дней)\r\n- **Cancel Destruction** - отменить запланированное удаление версии\r\n\r\n**Операции с payload:**\r\n\r\n- **Get** - получить payload секрета (пары ключ-значение) по ID секрета\r\n  - Опциональный ID версии (по умолчанию текущая версия)\r\n  - Текстовые значения возвращаются как строки\r\n  - Бинарные значения возвращаются в кодировке base64\r\n- **Get by Name** - альтернативное получение payload через ID каталога + имя секрета\r\n  - Полезно для workflow без ID секрета\r\n  - Тот же формат вывода, что и у стандартной операции Get\r\n\r\n**Параметры создания секрета:**\r\n\r\n- `secretName` - уникальное имя секрета (обязательно)\r\n- `description` - человекочитаемое описание (опционально)\r\n- `payloadEntries` - пары ключ-значение с выбором типа (текст/бинарное)\r\n- `deletionProtection` - предотвращение случайного удаления (по умолчанию: false)\r\n- **Дополнительные опции:**\r\n  - `labels` - метки ключ-значение для организации\r\n  - `kmsKeyId` - ключ шифрования KMS для дополнительной безопасности\r\n  - `versionDescription` - описание для начальной версии\r\n\r\n**Аутентификация:** Использует JSON сервисного аккаунта через учётные данные `yandexCloudAuthorizedApi` с автоматическим управлением IAM-токенами. Поддерживает resource locators для удобного выбора секретов и версий из поисковых списков. Нода идеально подходит для безопасного управления учётными данными, хранения конфигураций, ротации сертификатов и соблюдения требований безопасности в автоматизированных workflow.\r\n\r\n**Функции безопасности:**\r\n\r\n- ✅ Неизменяемость версий - версии нельзя изменить после создания\r\n- ✅ Защита от удаления - предотвращение случайного удаления секретов\r\n- ✅ Шифрование KMS - шифрование секретов ключами, управляемыми клиентом\r\n- ✅ Контроль доступа - гранулированные IAM-разрешения\r\n- ✅ Аудит - все операции логируются через Cloud Logging\r\n- ✅ Жизненный цикл версий - планирование удаления с периодом ожидания\r\n\r\n---\r\n\r\n## Общие возможности\r\n\r\nВсе ноды в пакете поддерживают:\r\n\r\n- ✅ Continue on Fail - продолжение выполнения при ошибках\r\n- ✅ Paired Items - сохранение связи между входными и выходными элементами\r\n- ✅ Resource Locators - удобный выбор ресурсов из списков или ручной ввод\r\n- ✅ Expressions - использование n8n expressions во всех параметрах\r\n- ✅ Proxy Support - работа через HTTP/HTTPS прокси (где применимо)\r\n","readmeFilename":"README.ru.md","_rev":"1-84ef63d0ed07166258401e948dbfecfc"}