---
title: Инструменты MCP
description: Справочник 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](/docs/mcp).