Инструменты MCP

Справочник 10 базовых и 5 дополнительных инструментов Clipia MCP для AI-агента, плюс 7 app-only helpers для интерактивных карточек.

Clipia MCP всегда предоставляет 10 базовых инструментов для AI-агента плюс семь служебных app-only helpers, не попадающих в контекст модели. chat, generate_scenario, compose_video, generate_presentation и edit_presentation добавляются только при включённых возможностях. Каждый generate-вызов возвращает стоимость в кредитах; get_balance показывает остаток.

Типичный сценарий

generate_image / generate_video ставит задачу. Если ответ нетерминальный (статус IN_QUEUE / IN_PROGRESS), вызывайте wait_generation с request_id до статуса COMPLETED. Изображения часто приходят готовыми одним вызовом; видео рендерится 1–10 минут.

Справочник

Инструмент	Назначение	Ключевые параметры
`generate_image`	Изображение из текста или редактирование по референсам. Обычно возвращает готовый результат одним вызовом с превью	`prompt`, `model` (опц.), `image_url` (опц., I2I), `num_images` (1–4), `seed`
`generate_video`	Видео из текста или стартового кадра (image-to-video). Сразу отдаёт `request_id` и стоимость	`prompt`, `model` (опц.), `image_url` (опц., переключает на I2V), `seed`
`generate_audio`	Озвучка текста с выбором голоса и языка. Возвращает MP3 после завершения	`text`, `model` (опц.), `voice` (опц.), `language` (опц.)
`generate_music`	Фоновая музыка или саундтрек по описанию настроения, жанра и темпа	`prompt`, `model` (опц.), `instrumental` (опц.)
`wait_generation`	Long-poll до терминального статуса (≤30с за вызов)	`request_id`
`get_generation`	Мгновенный статус и результат: webp-превью + `original_url` в полном качестве	`request_id`, `include_preview` (опц.)
`list_models`	Каталог моделей: slug, тип, возможности, цена в кредитах	`type` (опц.), `search` (опц.)
`get_model`	Параметры конкретной модели (`input_schema`) и цена	`model`
`get_balance`	Баланс кредитов и расход по ключу за 30 дней	—
`search_templates`	Гибридный поиск по 3500+ отобранным для MCP промптам из общей библиотеки (RU/EN)	`query`, `limit` (опц.)

Инструменты, зависящие от возможностей

Инструмент	Назначение	Доступность
`chat`	Диалог с текстовой моделью с ответом, расходом и стоимостью в кредитах	Включён LLM gateway
`generate_scenario`	Преобразовать видеобриф в сцены, английские промпты генерации и промпт саундтрека	Включён LLM gateway
`compose_video`	Собрать 2–20 готовых видеосцен с опциональными озвучкой, музыкой и субтитрами	Включён серверный монтаж
`generate_presentation`	Создать редактируемые PPTX, PDF и PNG-превью по спецификации презентации	Включён Presentation Agent
`edit_presentation`	Изменить готовую презентацию, переиспользуя неизменившиеся иллюстрации	Включён Presentation Agent

App-only helpers

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

Инструмент	Назначение
`app_get_generation`	Получить состояние одной генерации для живой карточки результата
`app_get_generations`	Получить состояния нескольких карточек одним запросом
`app_get_rerun_options`	Загрузить безопасные параметры повторного запуска готовой генерации
`app_rerun_generation`	Повторить генерацию из интерактивной карточки после явного действия пользователя
`app_get_compose_editor`	Загрузить состояние редактора монтажа
`app_recompose_video`	Пересобрать смонтированное видео после явного изменения
`app_report_event`	Передать события жизненного цикла и взаимодействия с карточкой

Описания

generate_image — text-to-image и image-to-image по референсу (image_url). Параметр num_images (1–4) возвращает несколько вариантов одной плиткой. Для повторяемости задавайте seed.

generate_video — text-to-video и image-to-video; передача image_url переключает дефолт на I2V-модель. У видео нет батча — для нескольких вариантов делайте отдельные вызовы с разным seed.

generate_audio — text-to-speech: создаёт озвучку по тексту с выбранным голосом и языком. После статуса COMPLETED MP3 доступен в output.audio.url; request_id можно передать как voiceover_request_id в compose_video, если этот инструмент включён.

generate_music — создаёт фоновую музыку или саундтрек по текстовому описанию. По умолчанию результат инструментальный; после завершения MP3 доступен в output.audio.url.

wait_generation — ждёт готовности активной генерации; вызывайте между другой работой, пока статус не станет терминальным.

get_generation — мгновенный снимок статуса и результата без ожидания: оптимизированное webp-превью и original_url для скачивания полного качества.

list_models / get_model — каталог моделей с ценами и возможностями и подробная схема параметров конкретной модели.

get_balance — остаток кредитов и расход за 30 дней по текущему ключу.

search_templates — гибридный (полнотекстовый + семантический) поиск по библиотеке готовых промптов на русском и английском.

Дополнительные инструменты

chat и generate_scenario доступны при включённом LLM gateway; compose_video — при включённом серверном монтаже; generate_presentation и edit_presentation — при включённом Presentation Agent. Они не входят в базовые 10 инструментов.

Подсказки по промптам

Для видео-моделей лучше работают английские промпты (для изображений русский тоже подходит). Не вшивайте экранный текст в видео-промпт — он рендерится с артефактами, добавляйте подписи на монтаже. Для статичной камеры добавьте «static locked camera, no zoom, no pan».

Песочница

Ключ с префиксом clipia_test_ переводит все инструменты в тестовый режим: generate_image / generate_video мгновенно отдают детерминированный mock-результат, кредиты не списываются. Удобно отлаживать polling и разбор ответов в CI; для боевых генераций используйте ключ clipia_live_.

Адрес сервера и настройка клиентов — на странице Clipia MCP.

Инструменты MCP

Справочник

Инструменты, зависящие от возможностей

App-only helpers

Описания

On this page