MCP-инструмент · generate_video

Генерация видео прямо в диалоге с AI-агентом

Опишите ролик — агент запустит generate_video, получит request_id и стоимость, а затем дождётся результата через wait_generation. Нормальный long-poll, а не обёртка, которая отваливается по таймауту.

generate_video — инструмент MCP-сервера Clipia для генерации видео из текста. Агент задаёт промпт, длительность, соотношение сторон и разрешение; инструмент сразу возвращает request_id и стоимость в кредитах, после чего статус дожидается отдельным вызовом wait_generation (long-poll до 30 секунд за раз). Это устойчивее community-обёрток, которые рвут соединение по таймауту на длинных видео.

Параметры инструмента

ПараметрТипОбяз.Описание
promptstringдаОписание ролика (EN рекомендуется)
modelstringSlug видео-модели
durationnumber (сек)Длительность, обычно 5–10 с
aspect_ratiostring16:9, 9:16, 1:1
resolutionstring480p / 720p / 1080p
image_urlstringHTTPS-кадр → переключает на image-to-video
generate_audioboolСгенерировать звук (если модель умеет)

Пример запроса (MCP tools/call)

{
  "name": "generate_video",
  "arguments": {
    "prompt": "slow dolly-in on a neon coffee cup, steam rising, cinematic",
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "duration": 5
  }
}

Пример ответа

{
  "request_id": "a7b2...­4ce",
  "status": "IN_PROGRESS",
  "model": "seedance-2-fast-t2v",
  "cost_credits": 12,
  "next_step": "call wait_generation with this request_id"
}

Без таймаутов

Статус видео дожидается через wait_generation (long-poll до 30 с за вызов) — соединение не рвётся на длинных роликах.

Цена видна заранее

cost_credits возвращается сразу при запуске — агент знает стоимость до ожидания.

Серии и пайплайны

Агент может запустить несколько роликов 9:16 для соцсетей одним диалогом или встроить генерацию в CI headless.

Подключить за минуту

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

Для claude.ai и ChatGPT ключ не нужен — вход по аккаунту. Ключ создаётся в настройках Clipia.

Стоимость

Стоимость в кредитах возвращается сразу при запуске (cost_credits) и зависит от модели, длительности и разрешения.

Частые вопросы

Видео генерируется дольше картинки. generate_video отдаёт request_id, а результат агент забирает через wait_generation.

Да — передайте image_url, и инструмент работает в режиме image-to-video.

Да, подключение по API-ключу работает headless — на сервере и в пайплайнах.