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şlemi zaman aşımı. Belirtilmediğinde OpenClaw, yapılandırılmışsa agents.defaults.videoGenerationModel.timeoutMs değerini; aksi hâlde varsa plugin tarafından tanımlanan sağlayıcı varsayılanını kullanır. OPENCLAW_DOCS_MARKER:paramClose:

Referans girişleri çalışma zamanı modunu seçer:

• Referans ortamı yok -> generate
• Herhangi bir görüntü referansı -> imageToVideo
• Herhangi bir video referansı -> videoToVideo
• Referans ses girişleri çö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.

Görüntü ve video referanslarının birlikte kullanılması kararlı, ortak bir yetenek yüzeyi değildir. İstek başına tek bir referans türünü tercih edin.

Geri dönüş ve türü belirtilmiş 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, yetenekli bir geri dönüş sağlayıcısında çalışmaya devam edebilir:

• Etkin aday maxInputAudios bildirmiyorsa (veya 0 bildiriyorsa) ve istek ses referansları içeriyorsa atlanır; sonraki aday denenir. Aynı koruma, görüntü ve video referansı sayılarının maxInputImages/maxInputVideos sınırlarıyla karşılaştırılmasında da uygulanır.
• Etkin adayın maxDurationSeconds değeri istenen durationSeconds değerinden düşükse ve bildirilmiş bir supportedDurationSeconds listesi yoksa aday atlanır.
• İstek providerOptions içeriyorsa ve etkin aday açıkça türü belirtilmiş bir providerOptions şeması bildiriyorsa, sağlanan anahtarlar şemada bulunmadığında veya değer türleri eşleşmediğinde aday atlanır. Bildirilmiş şeması olmayan sağlayıcılar seçenekleri olduğu gibi alır (geriye dönük uyumlu doğrudan iletim). Bir sağlayıcı boş bir şema (capabilities.providerOptions: {}) bildirerek tüm sağlayıcı seçeneklerini devre dışı bırakabilir; bu, tür uyuşmazlığıyla aynı şekilde atlanmasına neden olur.

Bir istekteki ilk atlama nedeni warn düzeyinde günlüğe kaydedilir; böylece operatörler birincil sağlayıcılarının ne zaman atlandığını görür. Uzun geri dönüş zincirlerini sessiz tutmak için sonraki atlamalar debug düzeyinde kaydedilir. Her aday atlanırsa birleştirilmiş hata, her birinin atlanma nedenini içerir.

Eylemler

Model seçimi

OpenClaw modeli şu sırayla çözümler:

1. model araç parametresi - aracı çağırırken ajan bir değer belirtmişse.
2. Yapılandırmadaki videoGenerationModel.primary.
3. Sırayla videoGenerationModel.fallbacks.
4. Otomatik algılama - geçerli kimlik doğrulaması bulunan sağlayıcılar; önce geçerli varsayılan sağlayıcı, ardından alfabetik sırayla kalan 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 denemenin ayrıntılarını içerir.

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

{  agents: {    defaults: {      videoGenerationModel: {        primary: "google/veo-3.1-fast-generate-preview",        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],        timeoutMs: 180000, // araç başına sağlayıcı isteği zaman aşımını isteğe bağlı olarak geçersiz kılma      },    },  },}

Sağlayıcı notları

Sağlayıcı yetenek modları

Paylaşılan video üretme 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 belirtmek için yeterli değildir. Canlı testlerin, sözleşme testlerinin ve paylaşılan video_generate aracının mod desteğini belirlenimci biçimde doğrulayabilmesi için sağlayıcılar generate, imageToVideo ve videoToVideo alanlarını açıkça bildirmelidir.

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 ve 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

Depo sarmalayıcısı:

pnpm test:live:media video

Bu canlı dosya varsayılan olarak önceden dışa aktarılmış sağlayıcı ortam değişkenlerini saklanan kimlik doğrulama profillerinden önce kullanır ve varsayılan olarak sürüm için güvenli bir duman testi çalıştırır:

• Taramadaki FAL dışındaki her sağlayıcı için generate.
• Bir saniyelik ıstakoz istemi.
• OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS üzerinden sağlayıcı başına işlem sınırı (varsayılan olarak 180000).

Sağlayıcı tarafındaki kuyruk gecikmesi sürüm süresine baskın gelebileceğinden FAL isteğe bağlıdır:

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

Paylaşılan taramanın yerel ortamlarla güvenli biçimde çalıştırabildiği bildirilmiş 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.

Şu anda paylaşılan videoToVideo canlı hattı, yalnızca runway/gen4_aleph seçtiğinizde runway sağlayıcısını kapsar.

Yapılandırma

OpenClaw yapılandırmanızda varsayılan video üretme modelini ayarlayın:

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

Veya CLI aracılığıyla:

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 takibi
• BytePlus
• ComfyUI
• Yapılandırma referansı
• fal
• Google (Gemini)
• MiniMax
• Modeller
• OpenAI
• Qwen
• Runway
• Together AI
• Araçlara genel bakış
• Vydra
• xAI