Clipia для AI-агентов

Clipia MCP — удалённый сервер Model Context Protocol по адресу https://mcp.clipia.ai/mcp. Через него агент работает с каталогом из 60+ моделей изображений и видео: генерирует видео по тексту или стартовому кадру, создаёт и редактирует изображения, озвучивает текст, пишет музыку, собирает многосценовые ролики, делает презентации, смотрит каталог моделей, следит за задачами и возвращает готовые файлы в разговор. Если сценарий генерации принадлежит вашему приложению, а не агенту, используйте REST API или официальный SDK.

MCP или REST API: что выбрать?Скопировать ссылку на раздел

MCP и REST работают с одним аккаунтом Clipia, одним балансом кредитов и общей историей генераций там, где их возможности совпадают. Отдельной наценки за MCP нет.

Инструменты для AI-агентаСкопировать ссылку на раздел

Полный профиль, доступный по API-ключу, — 15 инструментов, которые может вызывать агент: 10 базовых и ещё пять, которые появляются, когда включены соответствующие возможности продукта. При входе через OAuth в claude.ai и ChatGPT набор может быть уже, например без get_balance. Точный набор для вашего подключения возвращает tools/list.

10 базовых инструментовСкопировать ссылку на раздел

• generate_image — создать или отредактировать изображение по промпту и референсам;
• generate_video — видео по тексту или стартовому кадру;
• generate_audio — озвучка текста;
• generate_music — фоновая музыка или саундтрек;
• wait_generation — дождаться завершения асинхронной задачи;
• get_generation — статус и ссылки на готовые файлы без ожидания;
• list_models — активные модели, их возможности и цены в кредитах;
• get_model — схема параметров и цена одной модели;
• get_balance — баланс кредитов подключённого аккаунта и недавний расход;
• search_templates — поиск готовых промптов для изображений и видео.

5 инструментов, зависящих от возможностейСкопировать ссылку на раздел

• chat — запрос к текстовой модели;
• generate_scenario — разбить видеобриф на сцены и промпты;
• compose_video — собрать готовые сцены, озвучку, музыку и субтитры в один ролик;
• generate_presentation — создать редактируемую презентацию: PPTX, PDF и превью слайдов;
• edit_presentation — изменить готовую презентацию, переиспользуя неизменённые иллюстрации.

Ещё семь служебных app-only helpers обслуживают живые карточки результата, перезапуска и монтажа. Они не попадают в контекст модели и не увеличивают список инструментов агента. Параметры и условия доступности — на странице «Инструменты MCP».

Готовые сценарии (prompts)Скопировать ссылку на раздел

Кроме инструментов сервер отдаёт четыре готовых сценария через prompts/list. В Claude Code они появляются как слэш-команды, в других клиентах — в меню промптов. Сценарий подставляет в разговор пошаговую инструкцию для агента, а генерации выполняются обычными инструментами и оплачиваются кредитами.

Видео от брифа до роликаСкопировать ссылку на раздел

Агент может довести работу до готового ролика, а не остановиться на одном клипе:

1. Вызвать generate_scenario, чтобы разбить бриф на сцены, если этот инструмент включён.
2. Вызвать generate_video для каждой сцены. Передать image_url, если кадр должен опираться на стартовое изображение.
3. При необходимости вызвать generate_audio для озвучки и generate_music для саундтрека.
4. Вызвать compose_video, чтобы собрать от 2 до 20 готовых сцен с озвучкой, музыкой и субтитрами.
5. Вызывать wait_generation, пока итоговая задача не перейдёт в COMPLETED, и вернуть output.video.url.

Для одного клипа достаточно generate_video и опроса по полученному request_id; сценарий и монтаж необязательны.

Где взять ключСкопировать ссылку на раздел

API-ключ создаётся в консоли разработчика. Ключи с префиксом clipia_live_ — боевые и списывают кредиты. Ключи с префиксом clipia_test_ работают в песочнице: мгновенные тестовые ответы без списания, удобно для отладки агентов и CI.

Подключение клиентаСкопировать ссылку на раздел

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer $CLIPIA_KEY"

Вход через OAuth (claude.ai, ChatGPT и другие клиенты с экраном согласия) действует 180 дней с момента, когда вы нажали «Разрешить»: затем клиент попросит войти в Clipia и подтвердить доступ заново. Отозвать доступ раньше можно в консоли разработчика на вкладке «Подключённые приложения» — приложение теряет доступ к аккаунту сразу. Смена пароля в настройках останавливает такие подключения до вашего следующего входа в аккаунт Clipia, а сброс пароля по ссылке из письма отзывает их.

Задачи, стоимость и безопасные повторыСкопировать ссылку на раздел

Изображение часто готово за один вызов. Видео, озвучка, музыка, монтаж и презентации выполняются асинхронно:

1. Инструмент генерации возвращает request_id, текущий статус и стоимость в кредитах.
2. Вызывайте wait_generation, пока статус не станет COMPLETED, FAILED или CANCELED.
3. После завершения берите ссылки на медиа или документы из output.

Передавайте один и тот же idempotency_key, только когда повторяете тот же неизменённый платный запрос после сбоя связи или неясной ошибки. Если изменили промпт, файлы или настройки — нужен новый ключ: тот же ключ с другим входом, в том числе с другим num_images или при переходе между одиночным запуском и батчем, возвращает idempotency_key_reuse. Ключ — до 255 символов; его принимают generate_image, generate_video, generate_audio, generate_music, generate_scenario и chat. Так цикл агента не оплатит одну операцию дважды.

ПесочницаСкопировать ссылку на раздел

Ключи с префиксом clipia_test_ возвращают мгновенные тестовые результаты без списания кредитов — удобно отлаживать разбор ответов, опрос статуса и конвейеры. Боевые ключи показывают стоимость каждой генерации в ответе, а инструмент get_balance — остаток кредитов.

Вопросы агентского сценарияСкопировать ссылку на раздел

Машиночитаемое описаниеСкопировать ссылку на раздел

Агенты и поисковые роботы могут получить тот же контракт, не разбирая маркетинговый сайт:

• Факты о продукте и список инструментов для LLM
• Индекс документации для разработчиков
• Карточка MCP-сервера
• Индекс навыков агента
• Спецификация OpenAPI 3.1
• Описание авторизации

Карточка сервера строится по текущей конфигурации и показывает полный профиль для API-ключа; точный набор для вашего подключения возвращает tools/list. Полный справочник — на странице «Инструменты MCP», обзор REST — в «Справочнике API».