--- title: Clipia для AI-агентов description: Подключите Clipia к Claude Code, claude.ai, ChatGPT, Cursor, VS Code, Codex и Gemini CLI — более 60 моделей фото и видео в чате агента по ключу или OAuth. icon: Plug --- Clipia MCP — удалённый сервер Model Context Protocol по адресу `https://mcp.clipia.ai/mcp`. Через него агент работает с каталогом из 60+ моделей изображений и видео: генерирует видео по тексту или стартовому кадру, создаёт и редактирует изображения, озвучивает текст, пишет музыку, собирает многосценовые ролики, делает презентации, смотрит каталог моделей, следит за задачами и возвращает готовые файлы в разговор. Если сценарий генерации принадлежит вашему приложению, а не агенту, используйте REST API или официальный SDK. Адрес (Streamable HTTP): `https://mcp.clipia.ai/mcp`. Авторизация — API-ключом Clipia или входом в аккаунт через OAuth. Для ключа подходят заголовки `Authorization: Bearer clipia_...` (рекомендуется), `Authorization: Key <ключ>` и `X-Api-Key: <ключ>`. ## MCP или REST API: что выбрать? [#mcp-or-rest] | Что выбрать | Когда подходит | Что вы получаете | | --- | --- | --- | | **Удалённый MCP-сервер** | AI-агент сам находит инструменты и решает, какой шаг генерации выполнить | Streamable HTTP, схемы инструментов, вход по OAuth или API-ключу, интерактивные карточки результата в поддерживающих клиентах | | **REST API и SDK** | Сценарий генерации изображений и видео принадлежит вашему бэкенду, продукту или автоматизации | Очередь задач для изображений и видео, вебхуки, OpenAPI, официальные SDK для TypeScript и Python | MCP и REST работают с одним аккаунтом Clipia, одним балансом кредитов и общей историей генераций там, где их возможности совпадают. Отдельной наценки за MCP нет. ## Инструменты для AI-агента [#tools] Полный профиль, доступный по 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»](/ru/docs/mcp/tools). ## Готовые сценарии (prompts) [#prompts] Кроме инструментов сервер отдаёт четыре готовых сценария через `prompts/list`. В Claude Code они появляются как слэш-команды, в других клиентах — в меню промптов. Сценарий подставляет в разговор пошаговую инструкцию для агента, а генерации выполняются обычными инструментами и оплачиваются кредитами. | Сценарий | Что делает | Аргументы | | --- | --- | --- | | `product_shot` | Из одного фото товара делает набор для маркетплейса: несколько фонов и короткое видео с вращением | `image_url` (обязательный), `product`, `variants` (по умолчанию 4) | | `blog_covers` | Делает обложки в едином стиле для списка заголовков статей | `titles` (обязательный, по одному на строку), `style`, `aspect_ratio` (по умолчанию `16:9`) | | `campaign_storyboard` | Превращает бриф кампании в кадры сцен, анимирует одобренные и добавляет озвучку | `brief` (обязательный), `scenes` (по умолчанию 6), `voiceover` | | `animate_photo` | Оживляет фото: короткое видео с заданным движением камеры | `image_url` (обязательный), `motion`, `duration` (по умолчанию 5 секунд) | ## Видео от брифа до ролика [#video-workflow] Агент может довести работу до готового ролика, а не остановиться на одном клипе: 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`; сценарий и монтаж необязательны. ## Где взять ключ [#key] API-ключ создаётся в [консоли разработчика](/ru/developer). Ключи с префиксом `clipia_live_` — боевые и списывают кредиты. Ключи с префиксом `clipia_test_` работают в песочнице: мгновенные тестовые ответы без списания, удобно для отладки агентов и CI. Боевой ключ показывается один раз при создании — это пароль к балансу кредитов. Храните его в переменной окружения, например `CLIPIA_KEY`, или в менеджере секретов и не публикуйте в репозиториях. ## Подключение клиента [#connect] В claude.ai результат показывается интерактивной карточкой с живым прогрессом и медиа. В Claude Code превью приходит прямо в терминал. Клиенты без поддержки карточек получают ссылки на файл в полном качестве. Одна команда в терминале — и инструменты Clipia доступны в любой сессии, включая запуск без интерфейса и CI. Ключ берите из переменной окружения, не вписывайте его в команду: ```bash claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \ --header "Authorization: Bearer $CLIPIA_KEY" ``` После этого попросите Claude: «Сгенерируй в Clipia изображение неонового города» — превью придёт прямо в терминал. claude.ai (веб, десктоп, мобильное приложение) подключается через вход в аккаунт Clipia (OAuth), ключ не нужен: 1. Откройте Settings → Connectors (в новом интерфейсе — Customize → Connectors). 2. Нажмите «Add custom connector» и вставьте URL `https://mcp.clipia.ai/mcp`. 3. Нажмите Connect и войдите в аккаунт Clipia. 4. В новом чате попросите сгенерировать картинку или видео — в сообщении появится живая карточка Clipia с прогрессом и кнопкой «Оригинал». Кредиты списываются с подключённого аккаунта Clipia. На плане Claude Free доступен один пользовательский коннектор, на планах Team и Enterprise коннектор добавляет владелец организации. ChatGPT подключает сторонние MCP-серверы как плагины — через вход в аккаунт Clipia (OAuth), ключ не нужен: 1. Откройте страницу плагинов `chatgpt.com/plugins`, нажмите «+» → «Add custom MCP server». 2. Укажите название и описание, в поле Connection — адрес `https://mcp.clipia.ai/mcp`. 3. Выберите авторизацию OAuth, прочитайте предупреждение и подтвердите «I understand and want to continue», затем нажмите «Create as a plugin». 4. Проверьте список инструментов, установите плагин и войдите в аккаунт Clipia. В новом чате наберите `@`, выберите Clipia и просите генерации обычным текстом. Возможность добавлять свои MCP-серверы зависит от политик аккаунта и рабочего пространства ChatGPT. Если страницы плагинов у вас нет, действует прежний путь: Settings → Apps & Connectors → Advanced settings → Developer mode, затем Apps & Connectors → Create. Названия пунктов зависят от версии ChatGPT. Добавьте сервер в `~/.cursor/mcp.json` (глобально) или `.cursor/mcp.json` в проекте и перезапустите Cursor — инструменты Clipia появятся в режиме Agent. Ключ Cursor подставляет из переменной окружения через `${env:…}`: ```json { "mcpServers": { "clipia": { "url": "https://mcp.clipia.ai/mcp", "headers": { "Authorization": "Bearer ${env:CLIPIA_KEY}" } } } } ``` Создайте `.vscode/mcp.json` в рабочей папке (или командой «MCP: Add Server»). При первом запуске VS Code спросит ключ и сохранит его в защищённом хранилище; откройте Copilot Chat в режиме Agent — инструменты Clipia появятся в списке: ```json { "servers": { "clipia": { "type": "http", "url": "https://mcp.clipia.ai/mcp", "headers": { "Authorization": "Bearer ${input:clipia_api_key}" } } }, "inputs": [ { "type": "promptString", "id": "clipia_api_key", "description": "Clipia API Key", "password": true } ] } ``` Добавьте сервер в `~/.codeium/windsurf/mcp_config.json` (поле `serverUrl` — особенность Windsurf) и обновите список серверов в панели Cascade → MCPs: ```json { "mcpServers": { "clipia": { "serverUrl": "https://mcp.clipia.ai/mcp", "headers": { "Authorization": "Bearer clipia_live_..." } } } } ``` Документация Windsurf теперь ведёт на сайт Devin: если у вас новая сборка, конфиг лежит в `~/.config/devin/mcp_config.json` (для проекта — `.devin/mcp_config.json`), а адрес сервера задаётся полем `url`. Добавьте блок в `~/.codex/config.toml` и экспортируйте ключ в окружение — Codex сам подставит заголовок `Authorization: Bearer` из переменной `CLIPIA_API_KEY`: ```toml [mcp_servers.clipia] url = "https://mcp.clipia.ai/mcp" bearer_token_env_var = "CLIPIA_API_KEY" ``` ```bash export CLIPIA_API_KEY="clipia_live_..." ``` Одна команда (или блок `httpUrl` с заголовками в `~/.gemini/settings.json`); подключение проверяет `gemini mcp list`: ```bash gemini mcp add --transport http clipia https://mcp.clipia.ai/mcp \ --header "Authorization: Bearer $CLIPIA_KEY" ``` Вход через OAuth (claude.ai, ChatGPT и другие клиенты с экраном согласия) действует 180 дней с момента, когда вы нажали «Разрешить»: затем клиент попросит войти в Clipia и подтвердить доступ заново. Отозвать доступ раньше можно в [консоли разработчика](/ru/developer) на вкладке «Подключённые приложения» — приложение теряет доступ к аккаунту сразу. Смена пароля в настройках останавливает такие подключения до вашего следующего входа в аккаунт Clipia, а сброс пароля по ссылке из письма отзывает их. ## Задачи, стоимость и безопасные повторы [#jobs] Изображение часто готово за один вызов. Видео, озвучка, музыка, монтаж и презентации выполняются асинхронно: 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`. Так цикл агента не оплатит одну операцию дважды. ## Песочница [#sandbox] Ключи с префиксом `clipia_test_` возвращают мгновенные тестовые результаты без списания кредитов — удобно отлаживать разбор ответов, опрос статуса и конвейеры. Боевые ключи показывают стоимость каждой генерации в ответе, а инструмент `get_balance` — остаток кредитов. ## Вопросы агентского сценария [#faq] В Claude Code, Cursor, VS Code, Codex и Gemini CLI — API-ключом из консоли разработчика в заголовке `Authorization: Bearer clipia_...` (подходят и `Authorization: Key`, и `X-Api-Key`). claude.ai и ChatGPT подключаются входом в аккаунт Clipia по OAuth, ключ не нужен. Ключи `clipia_live_` списывают кредиты, `clipia_test_` работают в песочнице без списания. MCP и REST API используют один аккаунт и один баланс. Инструменты генерации списывают кредиты подключённого аккаунта по тем же ценам, что и сайт, отдельной наценки за MCP нет. Справочную цену модели показывают `list_models` и `get_model`, фактическую стоимость вызова — ответ инструмента, остаток — `get_balance` (при входе через OAuth в claude.ai и ChatGPT этого инструмента может не быть). Кредиты резервируются при запуске и списываются после готового результата; неудавшаяся генерация возвращает резерв. Генерация по боевому ключу и через OAuth работает только при активной подписке на clipia.ai: без неё инструмент вернёт отказ, даже если на балансе есть кредиты. Ключ `clipia_test_` работает без оплаты. `generate_image` ждёт до 25 секунд и обычно сразу отдаёт готовую картинку. Видео, озвучка, музыка, монтаж и презентации возвращают `request_id` сразу: дальше вызывайте `wait_generation` (до 30 секунд за вызов) или `get_generation`, пока статус не станет `COMPLETED`, `FAILED` или `CANCELED`. Видео рендерится от одной до десяти минут. `chat` и `generate_scenario` отвечают в одном вызове, а сервер держит вызов до двух минут: длинный ответ `chat` ограничивайте через `max_tokens`. Задача генерации продолжает выполняться на сервере, результат доступен по `request_id` через `get_generation`. Повтор того же платного вызова с тем же `idempotency_key` не создаёт вторую генерацию: ключ хранится 24 часа, а одинаковые вызовы в течение примерно 20 секунд склеиваются в одну и без ключа. `chat` и `generate_scenario` с тем же ключом вернут сохранённый ответ без нового списания. У `generate_presentation` и `edit_presentation` такого ключа нет, поэтому их повтор оплачивается заново. Задачу, ушедшую в работу, отменить нельзя. 120 запросов в минуту на API-ключ и 600 на все ключи аккаунта; у подключения через OAuth — 60 запросов в минуту. При превышении сервер отвечает `429` с заголовком `Retry-After`: подождите указанное время и повторите вызов. Подробнее — [«Лимиты»](/ru/docs/api-reference/rate-limits). ## Машиночитаемое описание [#discovery] Агенты и поисковые роботы могут получить тот же контракт, не разбирая маркетинговый сайт: - [Факты о продукте и список инструментов для LLM](https://clipia.ai/llms.txt) - [Индекс документации для разработчиков](https://clipia.ai/ru/docs/llms.txt) - [Карточка MCP-сервера](https://clipia.ai/.well-known/mcp/server-card.json) - [Индекс навыков агента](https://clipia.ai/.well-known/agent-skills/index.json) - [Спецификация OpenAPI 3.1](https://clipia.ai/openapi/clipia-v1.json) - [Описание авторизации](https://clipia.ai/auth.md) Карточка сервера строится по текущей конфигурации и показывает полный профиль для API-ключа; точный набор для вашего подключения возвращает `tools/list`. Полный справочник — на странице [«Инструменты MCP»](/ru/docs/mcp/tools), обзор REST — в [«Справочнике API»](/ru/docs/api-reference).