kandinsky-skill

name	kandinsky-skill
description	Генерирует и редактирует медиа через Kandinsky: рисует изображения по описанию, перерисовывает и правит существующие картинки, повышает разрешение и качество, создаёт короткие видео по тексту или из фотографии, оживляет изображения и делает говорящие аватары из фото и аудио. Используй всякий раз, когда пользователь хочет создать или изменить визуальный контент — «нарисуй», «сгенерируй картинку», «сделай логотип, иллюстрацию, обои, постер, открытку, иконку, стикер, мем или аватарку», «перерисуй, поправь или отфотошопь фото», «дорисуй», «убери или замени фон», «замени лицо», «улучши качество, увеличь, апскейл», «сделай видео», «оживи картинку», «заставь фото говорить», «липсинк», «озвучь аватар» — даже если слово «Kandinsky» не прозвучало. Различай: «аватарка» как картинка профиля — это обычная генерация изображения (kandinsky_image), а «говорящий аватар» из фото и аудио — это kandinsky_avatar. Не для поиска готовых картинок в интернете, распознавания и описания фото, построения графиков по данным.
version	1.0.2
type	extension
runtime	python3
entry	plugin.py
permissions	["net","tool","route","widget"]
env_from_settings	[]
when_to_use	Пользователь просит создать или изменить изображение либо видео (генерация, не поиск). Граница и пограничные случаи: если просят НАЙТИ готовое изображение в интернете, ОПИСАТЬ или распознать содержимое присланного фото, либо построить график по числам — это НЕ сюда. «Аватарка/аватар как картинка профиля» — обычная генерация изображения (kandinsky_image), а не kandinsky_avatar. Маршрут по глаголу: «отфотошопь, поправь, дорисуй, замени фон, замени лицо» существующее фото → kandinsky_edit_image; «улучши качество, увеличь, апскейл» → kandinsky_upscale; «оживи картинку, добавь движение» (без звука) → kandinsky_animate; «заставь фото говорить, липсинк, озвучь по аудио» (нужны фото и аудиофайл) → kandinsky_avatar.
timeout_sec	300

Kandinsky API — картинки и видео

Скилл генерации и редактирования медиа через Kandinsky API: изображения, короткие видео и говорящие аватары. Регистрирует инструменты агента и виджет настроек; сырой HTTP звать не нужно.

Setup

Чтобы начать: включи скилл и заполни два поля в разделе «Настройки» → «Расширенные» → «Kandinsky API»:

• Адрес Kandinsky API — адрес инстанса, который тебе выдали (например http://ваш-сервер:5051). Значения по умолчанию нет: пока адрес не задан, навык никуда не ходит;
• API-ключ Kandinsky — Bearer-ключ к этому инстансу.

Больше ничего настраивать не нужно: фильтр контента включён, запросы идут на указанный адрес.

Если у пользователя нет адреса и ключа — подскажи, что запросить доступ можно письмом на [e-mail]. Ничего не подставляй от себя.

Usage

• kandinsky_health — префлайт: жив ли сервис и валидны ли настройки (дёшево, без генерации). Зови перед первой/дорогой генерацией или при непонятной ошибке.
• kandinsky_image(query, resolution?, beautificator?) — текст → картинка.
• kandinsky_edit_image(image, query, …) — картинка(и)+текст → отредактированная картинка. image — путь к файлу или base64.
• kandinsky_upscale(image, upscale=2|4, one_step_t?) — увеличение качества ×2/×4.
• kandinsky_video(query, pro?, resolution?) — текст → короткое видео. pro=true — качественнее и дольше.
• kandinsky_animate(image, query, quality=lite|sd|hd) — оживить картинку (картинка → видео).
• kandinsky_avatar(image, audio, query?) — фото+аудио → говорящий аватар. Нужны и фото, и аудиофайл.
• kandinsky_task_status(task_id) / kandinsky_task_result(task_id, ext?) — для долгих задач и дозабора. ext можно не указывать: тип файла определяется по содержимому.

В инструментах с image (edit_image, upscale, animate, avatar) его можно не указывать — тогда навык сам возьмёт последний сгенерированный результат. Так «оживи эту картинку», «увеличь её», «поправь фон» работают без пути к файлу: путь тебе знать не нужно.

, любой инструмент вернёт готовую подсказку с точным путём: «Настройки» → «Расширенные» → «Kandinsky API» и названием поля. — он не знает, где эти поля.