Инструменты MCP
Справочник 10 базовых инструментов Clipia MCP для AI-агента и семи app-only helpers — изображения, видео, речь, музыка, статусы, каталог, баланс и промпты.
Clipia MCP всегда предоставляет 10 базовых инструментов для AI-агента плюс семь служебных app-only helpers, не попадающих в контекст модели. chat, generate_scenario, compose_video и generate_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+ готовым промптам (RU/EN) | query, limit (опц.) |
app_get_generation | App-only (скрыт от модели): поллинг статуса из интерактивной карточки claude.ai. Алиас get_generation | request_id, include_preview (опц.) |
Описания
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 — при включённом Presentation Agent. Они не входят в базовые 10 инструментов.
Подсказки по промптам
Для видео-моделей лучше работают английские промпты (для изображений русский тоже подходит). Не вшивайте экранный текст в видео-промпт — он рендерится с артефактами, добавляйте подписи на монтаже. Для статичной камеры добавьте «static locked camera, no zoom, no pan».
Песочница
Ключ с префиксом clipia_test_ переводит все инструменты в тестовый режим: generate_image / generate_video мгновенно отдают детерминированный mock-результат, кредиты не списываются. Удобно отлаживать polling и разбор ответов в CI; для боевых генераций используйте ключ clipia_live_.
Адрес сервера и настройка клиентов — на странице Clipia MCP.
Clipia MCP
Подключите Clipia к Claude Code, claude.ai, ChatGPT, Cursor, VS Code и Windsurf — 60+ моделей изображений и видео прямо в чате агента по одному API-ключу.
TypeScript SDK
Официальный TypeScript SDK Clipia (npm clipia-ai) — установка, инициализация клиента, постановка задачи в очередь и ожидание результата генерации.