Generowanie wideo

• generate — brak multimediów referencyjnych (tekst na film).
• imageToVideo — co najmniej jeden obraz referencyjny.
• videoToVideo — co najmniej jeden film referencyjny.

​

Szybki start

export GEMINI_API_KEY="your-key"

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

​

Jak działa generowanie asynchroniczne

1. OpenClaw przesyła żądanie do dostawcy i natychmiast zwraca identyfikator zadania.
2. Dostawca przetwarza zadanie w tle (zwykle od 30 sekund do kilku minut, zależnie od dostawcy i rozdzielczości; powolni dostawcy korzystający z kolejek mogą działać do upływu skonfigurowanego limitu czasu).
3. Gdy film jest gotowy, OpenClaw wznawia tę samą sesję za pomocą wewnętrznego zdarzenia ukończenia.
4. Agent zgłasza wynik w zwykłym trybie widocznej odpowiedzi sesji: automatyczna odpowiedź końcowa lub message(action="send"), gdy sesja wymaga narzędzia wiadomości. Jeśli sesja żądającego jest nieaktywna albo jej wznowienie się nie powiedzie, a wygenerowanych multimediów nadal brakuje w odpowiedzi o ukończeniu, OpenClaw wysyła idempotentną bezpośrednią wiadomość awaryjną z multimediami.

​

Cykl życia zadania

openclaw tasks list
openclaw tasks show <lookup>
openclaw tasks cancel <lookup>

​

Obsługiwani dostawcy

​

Macierz możliwości

​

Parametry narzędzia

​

Wymagane

​

Dane wejściowe treści

​

Sterowanie stylem

​

Zaawansowane

• Brak multimediów referencyjnych -> generate
• Dowolny obraz referencyjny -> imageToVideo
• Dowolny film referencyjny -> videoToVideo
• Referencyjne wejścia audio nie zmieniają wybranego trybu; są stosowane do trybu wybranego przez referencje obrazów lub filmów i działają wyłącznie z dostawcami deklarującymi maxInputAudios.

​

Przełączanie awaryjne i typowane opcje

• Aktywny kandydat, który nie deklaruje maxInputAudios (lub deklaruje 0), jest pomijany, gdy żądanie zawiera referencje audio; następuje próba użycia kolejnego kandydata. Ta sama kontrola dotyczy liczby referencji obrazów i filmów względem maxInputImages/maxInputVideos.
• Aktywny kandydat, którego maxDurationSeconds jest mniejsze od żądanego durationSeconds i który nie deklaruje listy supportedDurationSeconds -> zostaje pominięty.
• Żądanie zawiera providerOptions, a aktywny kandydat jawnie deklaruje typowany schemat providerOptions -> zostaje pominięty, jeśli podanych kluczy nie ma w schemacie lub typy wartości są niezgodne. Dostawcy bez zadeklarowanego schematu otrzymują opcje bez zmian (przekazywanie zgodne wstecznie). Dostawca może zrezygnować ze wszystkich opcji dostawcy, deklarując pusty schemat (capabilities.providerOptions: {}), co powoduje takie samo pominięcie jak niezgodność typów.

​

Akcje

​

Wybór modelu

1. Parametr narzędzia model — jeśli agent poda go w wywołaniu.
2. videoGenerationModel.primary z konfiguracji.
3. videoGenerationModel.fallbacks po kolei.
4. Automatyczne wykrywanie — dostawcy z prawidłowym uwierzytelnieniem, począwszy od bieżącego domyślnego dostawcy, a następnie pozostali dostawcy w kolejności alfabetycznej.

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],
        timeoutMs: 180000, // opcjonalne nadpisanie limitu czasu żądania dostawcy dla poszczególnych narzędzi
      },
    },
  },
}

​

Uwagi dotyczące dostawców

​

Tryby możliwości dostawców

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

​

Testy na żywo

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

pnpm test:live:media video

• generate dla każdego dostawcy innego niż FAL objętego przebiegiem testowym.
• Jednosekundowe polecenie z homarem.
• Limit czasu operacji dla każdego dostawcy określony przez OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (domyślnie 180000).

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

• imageToVideo, gdy capabilities.imageToVideo.enabled.
• videoToVideo, gdy capabilities.videoToVideo.enabled, a dostawca/model przyjmuje lokalne wejście wideo oparte na buforze we wspólnym przebiegu testowym.

​

Konfiguracja

{
  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"

​

Powiązane materiały

• Alibaba Model Studio
• Zadania w tle — śledzenie zadań asynchronicznego generowania wideo
• BytePlus
• ComfyUI
• Dokumentacja konfiguracji
• fal
• Google (Gemini)
• MiniMax
• Modele
• OpenAI
• Qwen
• Runway
• Together AI
• Przegląd narzędzi
• Vydra
• xAI