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

"status" повертає поточне завдання сеансу; "list" перевіряє провайдерів.

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

Референсні входи визначають режим виконання:

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

Поєднання референсних зображень і відео не є стабільною спільною поверхнею можливостей. Надавайте перевагу одному типу референсу в кожному запиті.

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

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

• Активний кандидат, який не оголошує maxInputAudios (або оголошує 0), пропускається, якщо запит містить аудіореференси; виконується спроба з наступним кандидатом. Та сама перевірка застосовується до кількості референсних зображень і відео відносно maxInputImages/maxInputVideos.
• Активний кандидат, у якого 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"],        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,  },}

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

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

Актуальні тести

Добровільно ввімкнене актуальне покриття для спільних вбудованих провайдерів:

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).

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

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

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

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

Наразі спільний актуальний напрям 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