## Обзор

Отслеживание объектов в видеокадрах с помощью трекера на основе памяти SAM3. Этот узел обрабатывает последовательность видеокадров и поддерживает идентификацию объектов между кадрами, используя либо начальные маски, либо текстовые подсказки для определения того, что необходимо отслеживать.

## Входные параметры

| Параметр | Описание | Тип данных | Обязательный | Диапазон |
| --- | --- | --- | --- | --- |
| `изображения` | Видеокадры в виде пакетных изображений | IMAGE | Да | Пакетные видеокадры |
| `model` | Модель SAM3 для отслеживания | MODEL | Да | Модель SAM3 |
| `начальная_маска` | Маска(и) для первого кадра отслеживания (по одной на объект). Обязательно, если не указан `condition`. | MASK | Нет | Одна маска на объект |
| `condition` | Текстовое условие для обнаружения новых объектов во время отслеживания. Обязательно, если не указан `начальная_маска`. | CONDITIONING | Нет | Текстовое условие |
| `порог_обнаружения` | Порог оценки для обнаружения по текстовой подсказке | FLOAT | Нет | от 0.0 до 1.0 (по умолчанию: 0.5) |
| `макс_объектов` | Максимальное количество отслеживаемых объектов. Начальные маски учитываются в этом лимите. Значение 0 использует внутреннее ограничение в 64. | INT | Нет | от 0 до 64 (по умолчанию: 0) |
| `интервал_обнаружения` | Запуск обнаружения каждые N кадров (1 = каждый кадр). Более высокие значения экономят вычислительные ресурсы. | INT | Нет | от 1 до безлимита (по умолчанию: 1) |

**Примечание:** Необходимо указать либо `initial_mask`, либо `conditioning`. Если оба параметра опущены, узел выдаст ошибку.

## Выходные параметры

| Имя выходного параметра | Описание | Тип данных |
| --- | --- | --- |
| `track_data` | Данные отслеживания, содержащие маски объектов и метаданные по всем видеокадрам | SAM3TrackData |

> Эта документация была создана с помощью ИИ. Если вы обнаружите ошибки или у вас есть предложения по улучшению, пожалуйста, внесите свой вклад! [Редактировать на GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SAM3_VideoTrack/ru.md)

---
**Source fingerprint (SHA-256):** `30768bdf5839c1d7b984675e68a127a27f21b17724a2dc885e27f00c272db3cb`
