​

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

• generate для запитів text-to-video без еталонних медіа
• imageToVideo, коли запит містить одне або кілька еталонних зображень
• videoToVideo, коли запит містить одне або кілька еталонних відео

​

Швидкий старт

1. Встановіть API-ключ для будь-якого підтримуваного провайдера:

export GEMINI_API_KEY="your-key"

2. За бажанням закріпіть модель за замовчуванням:

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

3. Попросіть агента:

Створи 5-секундне кінематографічне відео дружнього лобстера, який займається серфінгом на заході сонця.

​

Що відбувається, коли ви генеруєте відео

1. OpenClaw надсилає запит провайдеру й одразу повертає ID завдання.
2. Провайдер обробляє завдання у фоновому режимі (зазвичай від 30 секунд до 5 хвилин залежно від провайдера та роздільної здатності).
3. Коли відео готове, OpenClaw пробуджує ту саму сесію внутрішньою подією завершення.
4. Агент публікує готове відео назад в оригінальну розмову.

​

Життєвий цикл завдання

1. queued — завдання створено, очікує, поки провайдер його прийме.
2. running — провайдер виконує обробку (зазвичай від 30 секунд до 5 хвилин залежно від провайдера та роздільної здатності).
3. succeeded — відео готове; агент пробуджується та публікує його в розмову.
4. failed — помилка провайдера або тайм-аут; агент пробуджується з деталями помилки.

openclaw tasks list
openclaw tasks show <taskId>
openclaw tasks cancel <taskId>

​

Підтримувані провайдери

​

Оголошена матриця можливостей

​

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

​

Обов’язкові

​

Вхідні дані контенту

​

Керування стилем

​

Додатково

• Без еталонних медіа: generate
• Будь-яке еталонне зображення: imageToVideo
• Будь-яке еталонне відео: videoToVideo
• Еталонні аудіовходи не змінюють визначений режим; вони застосовуються поверх режиму, який вибирають еталонні зображення/відео, і працюють лише з провайдерами, які оголошують maxInputAudios

​

Fallback і типізовані параметри

• Якщо активний кандидат не оголошує maxInputAudios (або оголошує його як 0), його буде пропущено, коли запит містить еталонні аудіодані, і буде випробувано наступного кандидата.
• Якщо maxDurationSeconds активного кандидата менше за запитане durationSeconds і кандидат не оголошує список supportedDurationSeconds, його буде пропущено.
• Якщо запит містить providerOptions, а активний кандидат явно оголошує типізовану схему providerOptions, кандидат буде пропущено, якщо надані ключі відсутні в схемі або типи значень не збігаються. Провайдери, які ще не оголосили схему, отримують параметри як є (зворотно сумісна наскрізна передача). Провайдер може явно відмовитися від усіх параметрів провайдера, оголосивши порожню схему (capabilities.providerOptions: {}), що спричиняє той самий пропуск, що й невідповідність типів.

​

Дії

• generate (типово) — створити відео з вказаного запиту та необов’язкових еталонних вхідних даних.
• status — перевірити стан активного відеозавдання для поточної сесії без запуску нової генерації.
• list — показати доступних провайдерів, моделі та їхні можливості.

​

Вибір моделі

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"],
      },
    },
  },
}

​

Примітки щодо провайдерів

​

Режими можливостей провайдера

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    maxDurationSeconds: 5,
  },
  videoToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputVideos: 1,
    maxDurationSeconds: 5,
  },
}

​

Live-тести

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

pnpm test:live:media video

• generate для кожного провайдера у sweep, окрім FAL
• односекундний запит про лобстера
• ліміт операції для кожного провайдера з OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (180000 типово)

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

• imageToVideo, коли capabilities.imageToVideo.enabled
• videoToVideo, коли capabilities.videoToVideo.enabled і провайдер/модель приймає локальний вхід відео на основі буфера у спільному sweep

• лише runway, коли ви вибираєте runway/gen4_aleph

​

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

{
  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
• Довідник із конфігурації
• Моделі