Video oluşturma

• generate - referans medya olmayan metinden videoya istekleri.
• imageToVideo - istek bir veya daha fazla referans görsel içerir.
• videoToVideo - istek bir veya daha fazla referans video içerir.

​

Hızlı başlangıç

export GEMINI_API_KEY="your-key"

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

​

Eşzamansız oluşturma nasıl çalışır?

1. OpenClaw isteği sağlayıcıya gönderir ve hemen bir görev kimliği döndürür.
2. Sağlayıcı işi arka planda işler (sağlayıcıya ve çözünürlüğe bağlı olarak genellikle 30 saniye ile birkaç dakika; yavaş kuyruk destekli sağlayıcılar yapılandırılmış zaman aşımına kadar çalışabilir).
3. Video hazır olduğunda OpenClaw aynı oturumu dahili bir tamamlama olayıyla uyandırır.
4. Ajan, oturumun normal görünür yanıt modu üzerinden kullanıcıya bildirir: otomatik olduğunda son yanıt teslimiyle veya oturum mesaj aracını gerektirdiğinde message(action="send") ile. İstek yapan oturum etkin değilse veya etkin uyandırması başarısız olursa ve oluşturulan videonun bir kısmı tamamlama yanıtında hâlâ eksikse OpenClaw yalnızca eksik videoyu içeren idempotent bir doğrudan geri dönüş gönderir.

​

Görev yaşam döngüsü

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

​

Desteklenen sağlayıcılar

​

Yetenek matrisi

​

Araç parametreleri

​

Gerekli

​

İçerik girdileri

​

Stil denetimleri

​

Gelişmiş

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

​

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

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

​

Eylemler

​

Model seçimi

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.

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

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

​

Canlı testler

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

pnpm test:live:media video

• 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).

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

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

​

Yapılandırma

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

​

İ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