image-editредактирование изображений RunComfy
runcomfy-com/skills
Маршрутизирует правки изображений между четырьмя моделями RunComfy: пакетные правки, замена фона, сохранение идентичности или точные правки через Flux Kontext.
Установка
npx -y skills add runcomfy-com/skills --skill image-edit --agent claude-codeImage Edit — Pro Pack на RunComfy
Редактирование изображений с маршрутизацией по намерению. Этот скилл не привязывает к одной модели — он выбирает нужную модель редактирования из каталога RunComfy: пакетное сохранение идентичности, многоязычная перезапись текста, однократная точная правка или замена региона по маске.
npx skills add agentspace-so/runcomfy-skills --skill image-edit -g
Выбор модели по намерению
| Намерение пользователя | Модель | Почему |
|---|---|---|
| Пакетное редактирование 1–20 изображений согласованно (SKU, A/B) | Nano Banana Edit | До 20 входов; фиксированные aspect/resolution для серий |
| Замена фона с сохранением идентичности субъекта | Nano Banana Edit | Сильное сохранение под «keep X unchanged» |
| Локализованное удаление / добавление объектов по пространственному языку | Nano Banana Edit | Соблюдает направленные пространственные зоны |
| Многоязычный / не-латинский текст внутри изображения (японская кана, кириллица, арабский) | GPT Image 2 Edit | Лучший в классе для многоязычной типографики |
| Мультиреференсная композиция (субъект из img1, сцена из img2, палитра из img3) | GPT Image 2 Edit | Нумерованные cues направляются корректно |
| Layout-точное перемещение («переместить заголовок из top-right в bottom-center») | GPT Image 2 Edit | Направленный язык на уровне layout |
| Сохранение идентичности в вариантах переводных заголовков | GPT Image 2 Edit | Один ассет → варианты на разных языках, идентичность стабильна |
| Однократная точная локальная правка («теперь она держит оранжевый зонт») | Flux Kontext Pro | Один референс, одна инструкция, высокая точность |
| Удаление объектов по маске (провода, водяные знаки, лишние детали) | Z-Image Turbo Inpaint | Маска обязательна, регулируемая сила, согласованность краёв |
| Замена региона по маске (полная замена фона с маской) | Z-Image Turbo Inpaint | Высокая сила + чистая маска = чистая замена |
| По умолчанию (не указано) | Nano Banana Edit | Наиболее гибкий, поддерживает одиночное и пакетное |
Требования
- RunComfy CLI —
npm i -g @runcomfy/cli - Аккаунт RunComfy —
runcomfy login - CI/контейнеры —
RUNCOMFY_TOKEN=<token>
Маршрут 1: Nano Banana Edit — по умолчанию для общего редактирования + пакетов
Модель: google/nano-banana-2/edit
Схема
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
prompt | string | да | Сначала цели сохранения, потом изменение |
image_urls | array | да | 1–20 публично доступных HTTPS URL |
number_of_images | int | нет | 1–4 выхода на вызов |
aspect_ratio | enum | нет | auto следует входному; фиксируйте для пакета |
resolution | enum | нет | 0.5K / 1K / 2K / 4K |
seed | int | нет | Воспроизводимость |
runcomfy run google/nano-banana-2/edit \
--input '{
"prompt": "Keep the subject identity, pose, and clothing unchanged. Convert the background into a rainy neon cyberpunk street.",
"image_urls": ["https://.../portrait.jpg"]
}' \
--output-dir /абсолютный/путь
Маршрут 2: GPT Image 2 Edit — многоязычный текст + мультиреференсная композиция
Модель: openai/gpt-image-2/edit
Схема
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
prompt | string | да | Инструкция; начинайте с сохранения |
images | string[] | да | До 10 HTTPS URL. Первый — основной. |
size | enum | нет | auto, 1024_1024, 1024_1536, 1536_1024. Только эти. |
Советы
- Цитируйте встроенный текст точно. Называйте письменность: «Japanese kana», «Cyrillic», «Arabic right-to-left».
- Нумеруйте мультиреференсы: «subject from image 1, lighting from image 2».
- Направленный язык layout: «move the headline from top-right to bottom-center».
size: "auto"сохраняет соотношение входного — рекомендуется, если правка не меняет кадрирование.
Маршрут 3: Flux Kontext Pro — однократная точная локальная правка
Модель: blackforestlabs/flux-1-kontext/pro/edit
Схема
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
prompt | string | да | Одна декларативная инструкция по правке |
image | string | да | Одиночный URL источника. Для мультиизображений — Nano Banana Edit. |
aspect_ratio | enum | нет | Из поддерживаемых W:H значений |
seed | int | нет | Воспроизводимость |
runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
--input '{
"prompt": "Keep the person'\''s face, pose, and clothing unchanged. Add an orange umbrella in her left hand and a slight smile.",
"image": "https://.../portrait.jpg"
}' \
--output-dir /абсолютный/путь
Советы
- Одна декларативная инструкция в повелительном наклонении, одно изменение.
- Сначала сохранение — потом изменение.
- Составные правки дрейфуют — разбивайте на последовательные проходы.
Маршрут 4: Z-Image Turbo Inpaint — замена региона по маске
Модель: tongyi-mai/z-image/turbo/inpainting
Схема
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
prompt | string | да | Что заполнить / заменить; ограничения сохранения для немаскированного окружения |
image | string | да | URL исходного изображения |
mask_image | string | да | URL маски в градациях серого (белый = закрасить, чёрный = сохранить) |
strength | float | нет | 0.3–0.6 для ретуши; 0.7–1.0 для полной замены |
control_scale | float | нет | Обычно 0.6–0.9 |
seed | int | нет | Воспроизводимость |
Удаление объекта (низкая сила)
runcomfy run tongyi-mai/z-image/turbo/inpainting \
--input '{
"prompt": "Remove overhead cables; preserve rooflines and sky gradient; thin clean sky.",
"image": "https://.../street.jpg",
"mask_image": "https://.../cables-mask.png",
"strength": 0.5
}' \
--output-dir /абсолютный/путь
Замена региона (высокая сила)
runcomfy run tongyi-mai/z-image/turbo/inpainting \
--input '{
"prompt": "Replace busy backdrop with smooth light gray studio paper; mask background only.",
"image": "https://.../product.jpg",
"mask_image": "https://.../bg-mask.png",
"strength": 0.9
}' \
--output-dir /абсолютный/путь
Советы
- URL маски обязателен — градации серого, белый = закрасить. Лёгкое размытие краёв (1–3px) даёт лучшее смешение.
- Сила по намерению:
0.3–0.5для ретуши,0.6–0.7для замены с совпадением стиля,0.8–1.0для полной замены региона. - Называйте в промпте что остаётся вне маски: «preserve rooflines».
Ограничения
- Каждый маршрут наследует лимиты своей модели: Nano Banana — 1–20 входов; GPT Image 2 Edit — до 10 референсов, 4 фиксированных размера; Flux Kontext — один референс; Z-Image Inpaint — маска обязательна
- Нет смешения маршрутов — один вызов = одна модель
Коды выхода
| Код | Значение |
|---|---|
| 0 | успех |
| 64 | неверные аргументы CLI |
| 65 | неверный JSON / несоответствие схемы |
| 69 | ошибка сервера (5xx) |
| 75 | таймаут / 429 |
| 77 | не авторизован |
Из того же репозитория
codex-pet — кастомный питомец Codex
runcomfy-com/skills
Создаёт персонализированного Codex Pet без подписки Codex Pro или доступа к $imagegen. Чистая альтернатива через RunComfy CLI.
happyhorse-1-0 — генерация видео HappyHorse
runcomfy-com/skills
Оборачивает HappyHorse 1.0 — текст-в-видео модель, лидирующую на Artificial Analysis Video Benchmark — через RunComfy CLI для генерации высококачественного видео.
gpt-image-2 — генерация изображений GPT Image 2
runcomfy-com/skills
Генерирует изображения в Claude Code через существующую подписку ChatGPT Plus/Pro — не нужно платить за отдельный API-доступ к GPT Image 2.
flux-2-klein — быстрая генерация изображений Flux 2 Klein
runcomfy-com/skills
Black Forest Labs Flux 2 Klein — дистиллированная модель с минимальной задержкой. Обёртка для версий 9B и 4B через RunComfy с паттернами промптов.
elevenlabs-music-generation — генерация музыки ElevenLabs
runcomfy-com/skills
Обёртка ElevenLabs Music через RunComfy CLI: студийное качество песен и инструменталов из текстовых промптов с настройкой стиля и жанра.
image-to-video — анимация изображений в видео
runcomfy-com/skills
Маршрутизатор image-to-video на RunComfy: выбирает модель по намерению пользователя — анимация персонажей, сцен или реалистичное движение.
