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

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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg Необов’язковий тайм-аут операції провайдера в мілісекундах. Якщо пропущено, OpenClaw використовує agents.defaults.videoGenerationModel.timeoutMs, якщо налаштовано, інакше стандартне значення провайдера, задане Plugin, коли воно існує. 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, щоб живі тести, контрактні тести та спільний інструмент 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