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 OpenClaw, yapılandırılmışsa agents.defaults.videoGenerationModel.timeoutMs değerini, yoksa varsa plugin tarafından yazılmış sağlayıcı varsayılanını kullanır. OPENCLAW_DOCS_MARKER:paramClose:

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

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

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

Geri dönüş ve türlü seçenekler

Bazı yetenek denetimleri araç sınırı yerine geri dönüş katmanında uygulanır; bu nedenle birincil sağlayıcının sınırlarını aşan bir istek yine de yetenekli bir geri dönüşte ç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ş bir supportedDurationSeconds listesi olmadan istenen durationSeconds değerinin altındaysa → atlanır.
• İstek providerOptions içeriyor ve etkin aday açıkça türlü bir providerOptions şeması bildiriyorsa → sağlanan anahtarlar şemada değilse 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ş bir şema (capabilities.providerOptions: {}) bildirerek tüm sağlayıcı seçeneklerinden vazgeçebilir; bu, tür uyumsuzluğu ile 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 atlandığını görür; sonraki atlamalar uzun geri dönüş zincirlerini sessiz tutmak için debug düzeyinde günlüğe yazılır. Her aday atlanırsa, toplu hata her biri için atlama nedenini içerir.

Eylemler

Model seçimi

OpenClaw modeli şu sırayla çözer:

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

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 üretimi 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üşüm modu desteğini duyurmak için yeterli değildir. Sağlayıcılar generate, imageToVideo ve videoToVideo alanlarını açıkça bildirmelidir; 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 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 paketlenmiş 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 varsayılan olarak depolanan kimlik doğrulama profillerinden önce zaten dışa aktarılmış sağlayıcı ortam değişkenlerini kullanır ve varsayılan olarak sürüm açısından güvenli bir temel doğrulama testi çalıştırır:

• Taramadaki FAL olmayan her sağlayıcı için generate.
• Bir saniyelik ıstakoz istemi.
• Sağlayıcı başına işlem sınırı OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS üzerinden 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 bildirilen dönüşüm 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 üretimi modelini ayarlayın:

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

Veya 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 üretimi için görev izleme
• BytePlus
• ComfyUI
• Yapılandırma referansı
• fal
• Google (Gemini)
• MiniMax
• Modeller
• OpenAI
• Qwen
• Runway
• Together AI
• Araçlara genel bakış
• Vydra
• xAI