Video oluşturma

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 bir referans türünü tercih edin.

# Yedekleme ve tipli seçenekler

Bazı yetenek denetimleri araç sınırı yerine yedekleme katmanında uygulanır; bu nedenle birincil sağlayıcının sınırlarını aşan bir istek yine de yetkin bir yedek ü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 istenen durationSeconds değerinin altında ve bildirilmiş supportedDurationSeconds listesi yoksa → atlanır.
• İstek providerOptions içeriyor ve etkin aday açıkça tipli 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 çıkabilir; bu, tür uyuşmazlığıyla aynı atlamaya neden olur.

Bir istekteki ilk atlama nedeni warn düzeyinde kaydedilir; böylece operatörler birincil sağlayıcılarının ne zaman geçildiğini görür. Sonraki atlamalar, uzun yedek zincirlerini sessiz tutmak için debug düzeyinde kaydedilir. 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, 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 denemenin ayrıntılarını 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 değerlerini 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, kalanlara göre 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 paketli 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ı ortam değişkenlerini ~/.profile dosyasından yükler, varsayılan olarak canlı/ortam API anahtarlarını saklanan kimlik doğrulama profillerinden önce tercih eder ve varsayılan olarak sürüm için güvenli bir duman testi çalıştırır:

• Taramadaki FAL dışı 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 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 medyayla güvenli biçimde çalıştırabildiği bildirilen 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 girer.

# 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"],
      },
    },
  },
}

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