Инструменты MCP
Справочник 9 инструментов Clipia MCP — генерация изображений и видео, ожидание, статус, каталог моделей, баланс и поиск по шаблонам промптов.
Clipia MCP предоставляет 8 инструментов для AI-агента плюс один служебный (app-only). Схемы компактные — подключение Clipia почти не занимает контекст агента. Каждый 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 |
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.
wait_generation — ждёт готовности активной генерации; вызывайте между другой работой, пока статус не станет терминальным.
get_generation — мгновенный снимок статуса и результата без ожидания: оптимизированное webp-превью и original_url для скачивания полного качества.
list_models / get_model — каталог моделей с ценами и возможностями и подробная схема параметров конкретной модели.
get_balance — остаток кредитов и расход за 30 дней по текущему ключу.
search_templates — гибридный (полнотекстовый + семантический) поиск по библиотеке готовых промптов на русском и английском.
Подсказки по промптам
Для видео-моделей лучше работают английские промпты (для изображений русский тоже подходит). Не вшивайте экранный текст в видео-промпт — он рендерится с артефактами, добавляйте подписи на монтаже. Для статичной камеры добавьте «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 — 50+ моделей изображений и видео прямо в чате агента по одному API-ключу.
TypeScript SDK
Официальный TypeScript SDK Clipia (npm clipia-ai) — установка, инициализация клиента, постановка задачи в очередь и ожидание результата генерации.