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

Оживите изображение в видео прямо в чате

Передайте агенту стартовый кадр и движение — generate_video с параметром image_url превратит картинку в видео. Результат агент дождётся через wait_generation и покажет в диалоге.

Сценарий image-to-video использует тот же инструмент generate_video: как только в аргументах появляется image_url с HTTPS-ссылкой на стартовый кадр, генерация переключается из текст-в-видео в оживление изображения. Это удобно для продуктовых кадров, портретов и обложек: загрузили картинку, описали движение камеры — и агент собрал короткий ролик, не выходя из чата.

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

Параметр	Тип	Обяз.	Описание
`image_url`	string	да	HTTPS-ссылка на стартовый кадр
`prompt`	string	да	Описание движения и сцены
`model`	string	—	Slug видео-модели с поддержкой i2v
`duration`	number (сек)	—	Длительность ролика
`resolution`	string	—	480p / 720p / 1080p
`generate_audio`	bool	—	Добавить звук, если модель умеет

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

{
  "name": "generate_video",
  "arguments": {
    "image_url": "https://example.com/product.jpg",
    "prompt": "gentle parallax, camera slowly pushes in, soft light",
    "resolution": "720p",
    "duration": 5
  }
}

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

{
  "request_id": "c4d9...1fa",
  "status": "IN_PROGRESS",
  "model": "seedance-2-fast-i2v",
  "cost_credits": 12,
  "next_step": "call wait_generation with this request_id"
}

Один инструмент — два режима

generate_video сам переключается на image-to-video, когда передан image_url. Отдельный инструмент не нужен.

Продуктовые кадры в движении

Оживите снимок товара или обложку для Reels и Shorts прямо из диалога с агентом.

Проверка без списаний

Ключ clipia_test_* отдаёт mock мгновенно — отладьте сценарий заранее.

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

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

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

Стоимость

Стоимость в кредитах возвращается при запуске (cost_credits); image-to-video тарифицируется как видео-генерация.

Какой нужен стартовый кадр?

Любая публичная HTTPS-ссылка на изображение. Агент передаёт её в image_url.

Чем отличается от text-to-video?

Тем же инструментом, но с image_url — видео строится от вашего кадра, а не с нуля.

Сколько ждать?

Как и для text-to-video: статус дожидается через wait_generation, long-poll до 30 с за вызов.

Получить API-ключ Все инструменты MCP