​

Video Oluşturma

• referans medya içermeyen metinden videoya istekler için generate
• istek bir veya daha fazla referans görsel içerdiğinde imageToVideo
• istek bir veya daha fazla referans video içerdiğinde videoToVideo

​

Hızlı başlangıç

1. Desteklenen herhangi bir sağlayıcı için bir API anahtarı ayarlayın:

export GEMINI_API_KEY="your-key"

2. İsteğe bağlı olarak varsayılan bir modeli sabitleyin:

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

3. Agent’a isteğinizi söyleyin:

Gün batımında sörf yapan dost canlısı bir ıstakozun 5 saniyelik sinematik videosunu oluştur.

​

Video oluşturduğunuzda ne olur

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 (genellikle sağlayıcıya ve çözünürlüğe bağlı olarak 30 saniye ile 5 dakika arasında).
3. Video hazır olduğunda OpenClaw aynı oturumu dahili bir tamamlanma olayıyla uyandırır.
4. Agent tamamlanan videoyu özgün konuşmaya geri gönderir.

​

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

1. queued — görev oluşturuldu, sağlayıcının kabul etmesi bekleniyor.
2. running — sağlayıcı işliyor (genellikle sağlayıcıya ve çözünürlüğe bağlı olarak 30 saniye ile 5 dakika arasında).
3. succeeded — video hazır; agent uyanır ve videoyu konuşmaya gönderir.
4. failed — sağlayıcı hatası veya zaman aşımı; agent hata ayrıntılarıyla uyanır.

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

​

Desteklenen sağlayıcılar

​

Bildirilmiş yetenek matrisi

​

Araç parametreleri

​

Gerekli

​

İçerik girdileri

​

Stil denetimleri

​

Gelişmiş

• Referans medya 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 üzerine uygulanırlar ve yalnızca maxInputAudios bildiren sağlayıcılarla çalışırlar

​

Fallback ve türlü seçenekler

• Etkin aday maxInputAudios bildirmiyorsa (veya bunu 0 olarak bildiriyorsa), istek ses referansları içerdiğinde aday atlanır ve sonraki aday denenir.
• Etkin adayın maxDurationSeconds değeri istenen durationSeconds değerinden düşükse ve aday bir supportedDurationSeconds listesi bildirmiyorsa, aday atlanır.
• İstek providerOptions içeriyorsa ve etkin aday açıkça türlü bir providerOptions şeması bildiriyorsa, sağlanan anahtarlar şemada yoksa veya değer türleri eşleşmiyorsa aday atlanır. Henüz şema bildirmemiş 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 bildirerek (capabilities.providerOptions: {}) tüm sağlayıcı seçeneklerinden açıkça vazgeçebilir; bu da tür uyuşmazlığındakiyle aynı atlamaya neden olur.

​

Eylemler

• generate (varsayılan) — verilen prompt ve isteğe bağlı referans girdilerinden bir video oluşturur.
• status — başka bir oluşturma başlatmadan geçerli oturum için işlemde olan video görevinin durumunu kontrol eder.
• list — kullanılabilir sağlayıcıları, modelleri ve yeteneklerini gösterir.

​

Model seçimi

1. model araç parametresi — agent çağrıda bunu belirtirse.
2. videoGenerationModel.primary — config içinden.
3. videoGenerationModel.fallbacks — sırayla denenir.
4. Otomatik algılama — geçerli kimlik doğrulaması olan sağlayıcıları kullanır; önce mevcut varsayılan sağlayıcı, 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,
    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 dışı her sağlayıcı için generate
• bir saniyelik ıstakoz prompt’u
• OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS üzerinden sağlayıcı başına işlem sınırı (varsayılan olarak 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 tampon destekli yerel video girdisini kabul ettiğinde videoToVideo

• yalnızca runway/gen4_aleph seçildiğinde runway

​

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

• Araçlara Genel Bakış
• Arka Plan Görevleri — eşzamansız video oluşturma için görev takibi
• Alibaba Model Studio
• BytePlus
• ComfyUI
• fal
• Google (Gemini)
• MiniMax
• OpenAI
• Qwen
• Runway
• Together AI
• Vydra
• xAI
• Yapılandırma Başvurusu
• Modeller