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

• 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, // optional per-tool provider request timeout override
      },
    },
  },
}

​

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

​

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

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