Skip to main content

​
Обзор

comfyui-image-annotator — это интерактивный узел ComfyUI для аннотации изображений, внесенный участником сообщества luckdvr. Его ключевая ценность: снижение порога для написания prompt. Вместо того чтобы пытаться описать «замените красную кнопку в левом верхнем углу», вы просто обводите, щелкаете или выделяете рамкой область, которую хотите изменить, и позволяете модели точно увидеть, где нужно редактировать. Он предназначен для размещения перед узлом Nano Banana Pro в трехэтапном пайплайне: «изображение → аннотация → API».
Информация о проекте
  • 🔗 Источник: github.com/luckdvr/comfyui-image-annotator
  • 📜 Лицензия: MIT
  • 👤 Автор: luckdvr
  • ⭐ Вклад сообщества — тот же автор, что и у Luck Nano Banana Pro
Рекомендуемый workflow: Изображение → Аннотатор → узел API
Лучше всего подходит для пользователей, которым сложно писать prompt на английском или точно описывать «что и где редактировать». Пусть мышь отвечает за где, а короткий prompt в одну строку — за что.

​
Ключевые возможности

Три типа аннотаций

Точки (⦿): один щелчок · Прямоугольники (▢): перетаскивание для рисования · Многоугольники (⬡): несколько щелчков с автозакрытием

Рендеринг в реальном времени

Аннотации отображаются на холсте в реальном времени — WYSIWYG, без обратного перехода к предпросмотру

Масштабирование / панорамирование / выбор

Встроенные элементы управления холстом позволяют точно аннотировать даже большие изображения

Отмена на 50 шагов

До 50 шагов отмены — свободно экспериментируйте без страха

Два выходных результата

Выводит и аннотированное изображение (для модели), и annotation JSON (для последующего разбора)

Настраиваемое оформление

Цвет обводки, ширина обводки, прозрачность заливки, размер точки — все настраивается

​
Поддерживаемые модели APIYI

Этот узел сам по себе не вызывает никакой API — он только добавляет аннотации. Аннотированное изображение можно передать любой модели APIYI, которая принимает изображение на вход. Лучшие сочетания:

​
Сведения об узле

​
Вход

​
Выходы

​
Установка

1

Шаг 1: Склонируйте в custom_nodes

2

Шаг 2: Перезапустите ComfyUI

Никаких дополнительных зависимостей — используется встроенное окружение ComfyUI. После перезапуска найдите ImageAnnotator в палитре узлов.
3

Шаг 3: Подключите узлы в трехэтапном рабочем процессе

Подключите узлы по порядку:
Обведите область для редактирования на ImageAnnotator холсте, затем в downstream API-узле введите простой prompt (например, «замените отмеченную область на красный спортивный автомобиль») и запустите.

​
Примеры использования

​
Пример 1: Локальная замена (для начинающих)

1

Загрузите исходное изображение

LoadImage — загрузите фото вашей гостиной
2

Разметьте целевую область

ImageAnnotator — нарисуйте прямоугольник вокруг пустого места рядом с диваном
3

Напишите prompt в одну строку

Luck Nano Banana Pro — prompt: “Поставьте зеленое комнатное растение в отмеченную область”
4

Запустите и сохраните

Модель добавляет растение точно в выделенную вами область и оставляет остальное без изменений

​
Пример 2: Точные правки в нескольких областях

Используйте polygon для обводки одежды + point для расположения шляпы + rectangle для фона, затем укажите prompt:
Модель выполнит отдельные правки в каждой области.

​
Пример 3: Визуальные вопросы и ответы / понимание

С Gemini / Qwen-VL: попросите модель объяснить «что за объект находится внутри прямоугольника и какова его роль в сцене». Разметка дает модели точные визуальные ориентиры.

​
Частые вопросы

Традиционное редактирование изображений требует описывать и где, и как — это непросто для тех, для кого английский не родной, и для новичков в AI.С этим узлом информация о расположении поступает от мыши, поэтому prompt нужно описывать только что изменить. Описания, которые раньше занимали 3-5 предложений, превращаются в одну короткую фразу.
Да — в хорошем смысле. Большинство multimodal-моделей (Nano Banana, Gemini, Qwen-VL) распознают символы аннотаций на изображении как «обозначенные пользователем целевые области» и точнее следуют инструкциям.Если вас беспокоит визуальное перекрытие, уменьшите толщину линии и используйте полупрозрачную заливку в настройках узла.
  1. Подтвердите каталог: ComfyUI/custom_nodes/comfyui-image-annotator
  2. Полностью перезапустите ComfyUI (обновления интерфейса недостаточно)
  3. Проверьте консоль ComfyUI на наличие ошибок
Да — просто подключите только выход annotations_json дальше по цепочке. Полезно, когда нужно передать координаты в пользовательский скрипт для постобработки.
Рекомендуемая схема: LoadImage → ImageAnnotator → Luck Nano Banana Pro
  • Подключите ImageAnnotator.annotated_image к Luck Nano Banana Pro.image_01
  • Используйте prompt на естественном языке, описывающий «что делать с отмеченной областью»
  • Если первый результат неточен, используйте retry_times или режимы seed в Luck Nano Banana Pro, чтобы запустить заново

​
Связанные ресурсы

Luck Nano Banana Pro узел

Узел автора для вызова API — отлично сочетается с этим

Nano Banana Pro API

Полные возможности Nano Banana Pro

Коллекция узлов ComfyUI

Просмотрите все узлы ComfyUI для Nano Banana

Консоль APIYI

Управляйте ключами, использованием и каналами