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

"status" повертає поточне завдання сесії; "list" перевіряє постачальників.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg Необов'язковий тайм-аут операції постачальника в мілісекундах. Якщо пропущено, OpenClaw використовує agents.defaults.videoGenerationModel.timeoutMs, якщо його налаштовано. OPENCLAW_DOCS_MARKER:paramClose:

Еталонні входи вибирають режим виконання:

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

Змішані еталони зображень і відео не є стабільною спільною поверхнею можливостей. Віддавайте перевагу одному типу еталона на запит.

Резервний перехід і типізовані параметри

Деякі перевірки можливостей застосовуються на рівні резервного переходу, а не на межі інструмента, тому запит, який перевищує обмеження основного постачальника, може все одно виконатися на здатному резервному варіанті:

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

Перша причина пропускання в запиті журналюється на рівні warn, щоб оператори бачили, коли їхнього основного постачальника було обійдено; наступні пропуски журналюються на рівні debug, щоб довгі ланцюги резервних переходів залишалися тихими. Якщо пропущено кожного кандидата, сукупна помилка містить причину пропускання для кожного.

Дії

Вибір моделі

OpenClaw визначає модель у такому порядку:

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

Якщо постачальник завершується помилкою, автоматично пробується наступний кандидат. Якщо всі кандидати завершуються помилкою, помилка містить відомості з кожної спроби.

Задайте agents.defaults.mediaGenerationAutoProviderFallback: false, щоб використовувати лише явні записи model, primary і fallbacks.

{  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,    maxInputImagesByModel: { "provider/reference-to-video": 9 },    maxDurationSeconds: 5,  },  videoToVideo: {    enabled: true,    maxVideos: 1,    maxInputVideos: 1,    maxDurationSeconds: 5,  },}

Плоских сукупних полів на кшталт maxInputImages і maxInputVideos недостатньо, щоб оголосити підтримку режиму трансформації. Постачальники мають явно оголошувати generate, imageToVideo і videoToVideo, щоб live тести, контрактні тести та спільний інструмент video_generate могли детерміновано перевіряти підтримку режимів.

Коли одна модель у постачальника має ширшу підтримку вхідних посилань, ніж інші, використовуйте maxInputImagesByModel, maxInputVideosByModel або maxInputAudiosByModel замість підвищення обмеження для всього режиму.

Live тести

Опціональне live покриття для спільних вбудованих постачальників:

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

Обгортка репозиторію:

pnpm test:live:media video

Цей live файл завантажує відсутні змінні середовища постачальників із ~/.profile, за замовчуванням надає перевагу live/env ключам API перед збереженими профілями автентифікації та запускає безпечний для релізу smoke за замовчуванням:

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

FAL є опціональним, тому що затримка черги на боці постачальника може домінувати в часі релізу:

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

Установіть OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1, щоб також запускати оголошені режими трансформації, які спільний sweep може безпечно виконувати з локальними медіа:

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

Наразі спільна live лінія videoToVideo охоплює runway лише тоді, коли ви вибираєте runway/gen4_aleph.

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

Установіть модель генерації відео за замовчуванням у вашій конфігурації OpenClaw:

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

Або через CLI:

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