​

Generowanie filmów

• generate dla żądań tekst-na-film bez mediów referencyjnych
• imageToVideo gdy żądanie zawiera jeden lub więcej obrazów referencyjnych
• videoToVideo gdy żądanie zawiera jeden lub więcej filmów referencyjnych

​

Szybki start

1. Ustaw klucz API dla dowolnego obsługiwanego dostawcy:

export GEMINI_API_KEY="your-key"

2. Opcjonalnie przypnij domyślny model:

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

3. Poproś agenta:

Wygeneruj 5-sekundowy kinowy film przedstawiający przyjaznego homara surfującego o zachodzie słońca.

​

Co dzieje się podczas generowania filmu

1. OpenClaw wysyła żądanie do dostawcy i natychmiast zwraca identyfikator zadania.
2. Dostawca przetwarza zadanie w tle (zwykle od 30 sekund do 5 minut, w zależności od dostawcy i rozdzielczości).
3. Gdy film jest gotowy, OpenClaw wybudza tę samą sesję wewnętrznym zdarzeniem ukończenia.
4. Agent publikuje gotowy film z powrotem w oryginalnej rozmowie.

​

Cykl życia zadania

1. queued — zadanie utworzone, oczekuje na zaakceptowanie przez dostawcę.
2. running — dostawca przetwarza zadanie (zwykle od 30 sekund do 5 minut, w zależności od dostawcy i rozdzielczości).
3. succeeded — film gotowy; agent wybudza się i publikuje go w rozmowie.
4. failed — błąd dostawcy lub przekroczenie limitu czasu; agent wybudza się ze szczegółami błędu.

openclaw tasks list
openclaw tasks show <taskId>
openclaw tasks cancel <taskId>

​

Obsługiwani dostawcy

​

Zadeklarowana macierz możliwości

​

Parametry narzędzia

​

Wymagane

​

Wejścia treści

​

Kontrolki stylu

​

Zaawansowane

• Brak mediów referencyjnych: generate
• Dowolny obraz referencyjny: imageToVideo
• Dowolny film referencyjny: videoToVideo
• Referencyjne wejścia audio nie zmieniają rozstrzygniętego trybu; są stosowane dodatkowo do trybu wybranego przez referencje obrazu/filmu i działają tylko z dostawcami, którzy deklarują maxInputAudios

​

Fallback i opcje typowane

• Jeśli aktywny kandydat nie deklaruje maxInputAudios (lub deklaruje 0), jest pomijany, gdy żądanie zawiera referencje audio, i sprawdzany jest kolejny kandydat.
• Jeśli maxDurationSeconds aktywnego kandydata jest niższe niż żądane durationSeconds, a kandydat nie deklaruje listy supportedDurationSeconds, jest pomijany.
• Jeśli żądanie zawiera providerOptions, a aktywny kandydat jawnie deklaruje typowany schemat providerOptions, kandydat jest pomijany, gdy podane klucze nie występują w schemacie lub typy wartości nie pasują. Dostawcy, którzy jeszcze nie zadeklarowali schematu, otrzymują opcje bez zmian (zgodny wstecznie pass-through). Dostawca może jawnie zrezygnować ze wszystkich opcji dostawcy, deklarując pusty schemat (capabilities.providerOptions: {}), co powoduje takie samo pominięcie jak niedopasowanie typu.

​

Akcje

• generate (domyślnie) — utwórz film na podstawie podanego promptu i opcjonalnych wejść referencyjnych.
• status — sprawdź stan zadania generowania filmu będącego w toku dla bieżącej sesji bez uruchamiania kolejnego generowania.
• list — pokaż dostępnych dostawców, modele i ich możliwości.

​

Wybór modelu

1. Parametr narzędzia model — jeśli agent określi go w wywołaniu.
2. videoGenerationModel.primary — z konfiguracji.
3. videoGenerationModel.fallbacks — próbowane po kolei.
4. Automatyczne wykrywanie — używa dostawców z prawidłowym uwierzytelnianiem, zaczynając od bieżącego domyślnego dostawcy, a następnie pozostałych dostawców w kolejności alfabetycznej.

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],
      },
    },
  },
}

​

Uwagi o dostawcach

​

Tryby możliwości dostawców

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    maxDurationSeconds: 5,
  },
  videoToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputVideos: 1,
    maxDurationSeconds: 5,
  },
}

​

Testy live

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

pnpm test:live:media video

• generate dla każdego dostawcy w zestawie
• imageToVideo, gdy capabilities.imageToVideo.enabled
• videoToVideo, gdy capabilities.videoToVideo.enabled i dostawca/model akceptuje lokalne wejście wideo oparte na buforze we wspólnym zestawie

• runway tylko wtedy, gdy wybierzesz runway/gen4_aleph

​

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

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