Video oluşturma

"status" geçerli oturum görevini döndürür; "list" sağlayıcıları inceler.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg Milisaniye cinsinden isteğe bağlı sağlayıcı işlem zaman aşımı. Atlandığında, yapılandırılmışsa OpenClaw agents.defaults.videoGenerationModel.timeoutMs kullanır. OPENCLAW_DOCS_MARKER:paramClose:

Referans girdileri çalışma zamanı modunu seçer:

• Referans medya yok → generate
• Herhangi bir görüntü referansı → imageToVideo
• Herhangi bir video referansı → videoToVideo
• Referans ses girdileri çözümlenen modu değiştirmez; görüntü/video referanslarının seçtiği modun üzerine uygulanır ve yalnızca maxInputAudios bildiren sağlayıcılarla çalışır.

Karışık görüntü ve video referansları kararlı bir ortak yetenek yüzeyi değildir. İstek başına tek bir referans türünü tercih edin.

Fallback ve türlü seçenekler

Bazı yetenek denetimleri araç sınırı yerine fallback katmanında uygulanır; bu nedenle birincil sağlayıcının sınırlarını aşan bir istek yine de yetenekli bir fallback üzerinde çalışabilir:

• maxInputAudios bildirmeyen (veya 0 bildiren) etkin aday, istek ses referansları içerdiğinde atlanır; sonraki aday denenir.
• Etkin adayın maxDurationSeconds değeri, bildirilmiş supportedDurationSeconds listesi olmadan istenen durationSeconds değerinin altındaysa → atlanır.
• İstek providerOptions içerir ve etkin aday açıkça türlü bir providerOptions şeması bildirirse → sağlanan anahtarlar şemada yoksa veya değer türleri eşleşmiyorsa atlanır. Bildirilmiş şeması olmayan sağlayıcılar seçenekleri olduğu gibi alır (geriye dönük uyumlu geçiş). Bir sağlayıcı boş şema (capabilities.providerOptions: {}) bildirerek tüm sağlayıcı seçeneklerinden çıkabilir; bu da tür uyuşmazlığıyla aynı atlamaya neden olur.

Bir istekteki ilk atlama nedeni warn düzeyinde günlüğe yazılır; böylece operatörler birincil sağlayıcılarının ne zaman geçildiğini görür. Sonraki atlamalar, uzun fallback zincirlerini sessiz tutmak için debug düzeyinde günlüğe yazılır. Her aday atlanırsa, birleştirilmiş hata her biri için atlama nedenini içerir.

Eylemler

Model seçimi

OpenClaw modeli şu sırayla çözer:

1. model araç parametresi - aracı agent çağrıda bir tane belirtirse.
2. Yapılandırmadan videoGenerationModel.primary.
3. Sırayla videoGenerationModel.fallbacks.
4. Otomatik algılama - geçerli varsayılan sağlayıcıdan başlayarak, ardından kalan sağlayıcılar alfabetik sırayla, geçerli kimlik doğrulaması olan sağlayıcılar.

Bir sağlayıcı başarısız olursa, sonraki aday otomatik olarak denenir. Tüm adaylar başarısız olursa, hata her denemeden ayrıntılar içerir.

Yalnızca açık model, primary ve fallbacks girdilerini kullanmak için agents.defaults.mediaGenerationAutoProviderFallback: false ayarlayın.

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

Sağlayıcı notları

Sağlayıcı yetenek modları

Paylaşılan video oluşturma sözleşmesi yalnızca düz toplu sınırlar yerine moda özgü yetenekleri destekler. Yeni sağlayıcı uygulamaları açık mod bloklarını tercih etmelidir:

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 ve maxInputVideos gibi düz toplu alanlar, dönüştürme modu desteğini duyurmak için yeterli değildir. Sağlayıcılar generate, imageToVideo ve videoToVideo alanlarını açıkça tanımlamalıdır; böylece canlı testler, sözleşme testleri ve paylaşılan video_generate aracı mod desteğini deterministik olarak doğrulayabilir.

Bir sağlayıcıdaki tek bir model, diğerlerinden daha geniş referans girdisi desteğine sahipse mod genelindeki sınırı yükseltmek yerine maxInputImagesByModel, maxInputVideosByModel veya maxInputAudiosByModel kullanın.

Canlı testler

Paylaşılan birlikte sunulan sağlayıcılar için isteğe bağlı canlı kapsam:

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

Repo sarmalayıcısı:

pnpm test:live:media video

Bu canlı dosya eksik sağlayıcı env değişkenlerini ~/.profile dosyasından yükler, varsayılan olarak canlı/env API anahtarlarını saklanan kimlik doğrulama profillerinden önce tercih eder ve varsayılan olarak sürüm için güvenli bir smoke çalıştırır:

• Taramadaki FAL dışındaki her sağlayıcı için generate.
• Bir saniyelik ıstakoz promptu.
• Sağlayıcı başına işlem sınırı OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS değerinden alınır (varsayılan 180000).

FAL isteğe bağlıdır çünkü sağlayıcı tarafındaki kuyruk gecikmesi sürüm süresine baskın gelebilir:

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

Paylaşılan taramanın yerel medya ile güvenle çalıştırabileceği tanımlı dönüştürme modlarını da çalıştırmak için OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1 ayarlayın:

• capabilities.imageToVideo.enabled olduğunda imageToVideo.
• capabilities.videoToVideo.enabled olduğunda ve sağlayıcı/model paylaşılan taramada arabellek destekli yerel video girdisini kabul ettiğinde videoToVideo.

Bugün paylaşılan videoToVideo canlı hattı, yalnızca runway/gen4_aleph seçtiğinizde runway kapsamına alır.

Yapılandırma

OpenClaw yapılandırmanızda varsayılan video oluşturma modelini ayarlayın:

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

Ya da CLI üzerinden:

openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v"

İlgili

• Alibaba Model Studio
• Arka plan görevleri - eşzamansız video oluşturma için görev takibi
• BytePlus
• ComfyUI
• Yapılandırma başvurusu
• fal
• Google (Gemini)
• MiniMax
• Modeller
• OpenAI
• Qwen
• Runway
• Together AI
• Araçlara genel bakış
• Vydra
• xAI