Генерация видео

• generate — без референсных медиафайлов (преобразование текста в видео).
• imageToVideo — одно или несколько референсных изображений.
• videoToVideo — одно или несколько референсных видео.

​

Быстрый старт

export GEMINI_API_KEY="your-key"

openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"

​

Как работает асинхронная генерация

1. OpenClaw отправляет запрос провайдеру и сразу возвращает идентификатор задачи.
2. Провайдер обрабатывает задачу в фоновом режиме (обычно от 30 секунд до нескольких минут в зависимости от провайдера и разрешения; медленные провайдеры с очередями могут работать до истечения настроенного времени ожидания).
3. Когда видео готово, OpenClaw возобновляет тот же сеанс с внутренним событием завершения.
4. Агент сообщает о результате через обычный режим видимых ответов сеанса: автоматический итоговый ответ или message(action="send"), если сеанс требует использования инструмента сообщений. Если сеанс инициатора неактивен либо его возобновление завершается сбоем и созданный медиафайл по-прежнему отсутствует в ответе о завершении, OpenClaw отправляет идемпотентный прямой резервный ответ с медиафайлом.

​

Жизненный цикл задачи

openclaw tasks list
openclaw tasks show <lookup>
openclaw tasks cancel <lookup>

​

Поддерживаемые провайдеры

​

Матрица возможностей

​

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

​

Обязательные

​

Входные данные контента

​

Управление стилем

​

Расширенные параметры

• Нет референсных медиафайлов -> generate
• Есть референсное изображение -> imageToVideo
• Есть референсное видео -> videoToVideo
• Референсные входные аудиоданные не изменяют определённый режим; они применяются поверх режима, выбранного референсными изображениями/видео, и работают только с провайдерами, которые объявляют maxInputAudios.

​

Резервное переключение и типизированные параметры

• Активный кандидат, не объявляющий maxInputAudios (или 0), пропускается, если запрос содержит аудиореференсы; затем проверяется следующий кандидат. Та же проверка применяется к количеству референсных изображений и видео относительно maxInputImages/maxInputVideos.
• Если maxDurationSeconds активного кандидата меньше запрошенного durationSeconds и список supportedDurationSeconds не объявлен, кандидат пропускается.
• Если запрос содержит providerOptions, а активный кандидат явно объявляет типизированную схему providerOptions, кандидат пропускается, если переданные ключи отсутствуют в схеме или типы значений не совпадают. Провайдеры без объявленной схемы получают параметры без изменений (обратно совместимая сквозная передача). Провайдер может полностью отказаться от параметров провайдера, объявив пустую схему (capabilities.providerOptions: {}), что приводит к такому же пропуску, как при несоответствии типов.

​

Действия

​

Выбор модели

1. Параметр инструмента model — если агент указывает его в вызове.
2. videoGenerationModel.primary из конфигурации.
3. videoGenerationModel.fallbacks по порядку.
4. Автоматическое определение — провайдеры с действительными данными аутентификации, начиная с текущего провайдера по умолчанию, а затем остальные провайдеры в алфавитном порядке.

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],
        timeoutMs: 180000, // необязательное переопределение тайм-аута запроса провайдера для отдельного инструмента
      },
    },
  },
}

​

Примечания о провайдерах

​

Режимы возможностей провайдеров

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    maxInputImagesByModel: { "provider/reference-to-video": 9 },
    maxDurationSeconds: 5,
  },
  videoToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputVideos: 1,
    maxDurationSeconds: 5,
  },
}

​

Тесты в реальной среде

OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts

pnpm test:live:media video

• generate для каждого провайдера в проверке, кроме FAL.
• Односекундный запрос с лобстером.
• Ограничение числа операций для каждого провайдера из OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (по умолчанию 180000).

pnpm test:live:media video --video-providers fal

• imageToVideo, когда capabilities.imageToVideo.enabled.
• videoToVideo, когда capabilities.videoToVideo.enabled и провайдер или модель принимает в общей проверке локальный видеофайл на основе буфера.

​

Конфигурация

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "qwen/wan2.6-t2v",
        fallbacks: ["qwen/wan2.6-r2v-flash"],
      },
    },
  },
}

openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v"

​

Связанные материалы

• Alibaba Model Studio
• Фоновые задачи — отслеживание задач асинхронной генерации видео
• BytePlus
• ComfyUI
• Справочник по конфигурации
• fal
• Google (Gemini)
• MiniMax
• Модели
• OpenAI
• Qwen
• Runway
• Together AI
• Обзор инструментов
• Vydra
• xAI