Skip to main content
OpenClaw ajanları, metin istemlerinden, referans görsellerden veya mevcut videolardan video_generate aracılığıyla videolar oluşturur. On altı sağlayıcı arka ucu desteklenir; ajan, yapılandırmaya ve kullanılabilir API anahtarlarına göre doğru olanı otomatik olarak seçer.
video_generate, yalnızca en az bir video oluşturma sağlayıcısı kullanılabilir olduğunda görünür. Ajan araçlarınızda yoksa bir sağlayıcı API anahtarı ayarlayın veya agents.defaults.mediaModels.video öğesini yapılandırın.
video_generate, çağrıdaki referans girdilerinden belirlenen üç çalışma zamanı moduna sahiptir:
  • generate - referans medya yok (metinden videoya).
  • imageToVideo - bir veya daha fazla referans görsel.
  • videoToVideo - bir veya daha fazla referans video.
Sağlayıcılar bu modların herhangi bir alt kümesini destekleyebilir. Araç, gönderimden önce etkin modu doğrular ve desteklenen modları action=list içinde bildirir.

Hızlı başlangıç

1

Kimlik doğrulamayı yapılandırın

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

Varsayılan model seçin (isteğe bağlı)

3

Ajandan isteyin

Gün batımında sörf yapan sevimli bir ıstakozun 5 saniyelik sinematik videosunu oluştur.
Ajan, video_generate öğesini otomatik olarak çağırır. Araç için izin verilenler listesi gerekmez.

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

Video oluşturma eşzamansızdı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 arasında; kuyruk destekli yavaş 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 tamamlanma olayıyla uyandırır.
  4. Ajan, bunu oturumun normal görünür yanıt modu aracılığıyla bildirir: otomatik son yanıt veya oturum mesaj aracını gerektiriyorsa message(action="send"). İstekte bulunan oturum etkin değilse ya da uyandırma işlemi başarısız olur ve oluşturulan medya tamamlanma yanıtında hâlâ yoksa OpenClaw, medyayı içeren eş etkili doğrudan bir geri dönüş gönderir.
Bir iş devam ederken aynı oturumdaki yinelenen video_generate çağrıları, başka bir oluşturma başlatmak yerine mevcut görev durumunu döndürür. Yeni bir oluşturmayı tetiklemeden kontrol etmek için action: "status", CLI üzerinden ise openclaw tasks list / openclaw tasks show <lookup> kullanın (bkz. Arka plan görevleri). Oturum destekli ajan çalıştırmalarının dışında (örneğin doğrudan araç çağrılarında) araç, satır içi oluşturmaya geri döner ve son medya yolunu aynı turda döndürür. Sağlayıcı bayt döndürdüğünde, oluşturulan video dosyaları OpenClaw tarafından yönetilen medya depolamasına kaydedilir. Varsayılan üst sınır 16MB’dir (paylaşılan video medya sınırı); agents.defaults.mediaMaxMb, daha büyük işlemeler için bu sınırı yükseltir. Bir sağlayıcı barındırılan bir çıktı URL’si de döndürürse OpenClaw, yerel kalıcılık fazla büyük bir dosyayı reddettiğinde görevi başarısız kılmak yerine bu URL’yi teslim eder.

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

Durumu CLI üzerinden kontrol edin:

Desteklenen sağlayıcılar

Bazı sağlayıcılar ek veya alternatif API anahtarı ortam değişkenlerini kabul eder. Ayrıntılar için tek tek sağlayıcı sayfalarına bakın. Çalışma zamanında kullanılabilir sağlayıcıları, modelleri ve çalışma zamanı modlarını incelemek için video_generate action=list komutunu çalıştırın.

Yetenek matrisi

video_generate, sözleşme testleri ve paylaşılan canlı tarama tarafından kullanılan açık mod sözleşmesi:

Araç parametreleri

Zorunlu

string
gerekli
Oluşturulacak videonun metinsel açıklaması. action: "generate" için gereklidir.

İçerik girdileri

string
Tek referans görsel (yol veya URL).
string[]
Birden fazla referans görsel (en fazla 9).
string[]
Birleştirilmiş görsel listesine paralel, konuma göre isteğe bağlı rol ipuçları. Standart değerler: first_frame, last_frame, reference_image.
string
Tek referans video (yol veya URL).
string[]
Birden fazla referans video (en fazla 4).
string[]
Birleştirilmiş video listesine paralel, konuma göre isteğe bağlı rol ipuçları. Standart değer: reference_video.
string
Tek referans ses (yol veya URL). Sağlayıcı ses girdilerini desteklediğinde arka plan müziği veya ses referansı için kullanılır.
string[]
Birden fazla referans ses (en fazla 3).
string[]
Birleştirilmiş ses listesine paralel, konuma göre isteğe bağlı rol ipuçları. Standart değer: reference_audio.
Rol ipuçları sağlayıcıya değiştirilmeden iletilir. Standart değerler VideoGenerationAssetRole birleşiminden gelir, ancak sağlayıcılar ek rol dizelerini kabul edebilir. *Roles dizileri, karşılık gelen referans listesinden daha fazla giriş içermemelidir; bir basamaklık hatalar açık bir hata ile başarısız olur. Bir yuvayı ayarlanmamış bırakmak için boş dize kullanın. xAI için, reference_images oluşturma modunu kullanmak üzere her görsel rolünü reference_image olarak ayarlayın; tek görselli görselden videoya dönüştürme için rolü atlayın veya first_frame kullanın.

Stil denetimleri

string
1:1, 16:9, 9:16, adaptive gibi bir en-boy oranı ipucu veya sağlayıcıya özgü bir değer. OpenClaw, desteklenmeyen değerleri sağlayıcıya göre normalleştirir veya yok sayar.
string
360P, 480P, 540P, 720P, 768P, 1080P, 4K gibi bir çözünürlük ipucu veya sağlayıcıya özgü bir değer. OpenClaw, desteklenmeyen değerleri sağlayıcıya göre normalleştirir veya yok sayar.
number
Saniye cinsinden hedef süre (sağlayıcının desteklediği en yakın değere yuvarlanır).
string
Sağlayıcı desteklediğinde boyut ipucu.
boolean
Desteklendiğinde çıktıda oluşturulan sesi etkinleştirin. audioRef* (girdiler) ile aynı değildir.
boolean
Desteklendiğinde sağlayıcı filigranını açın veya kapatın.
adaptive, sağlayıcıya özgü bir nöbetçi değerdir: yeteneklerinde adaptive bildiren sağlayıcılara değiştirilmeden iletilir (ör. BytePlus Seedance, giriş görselinin boyutlarından oranı otomatik algılamak için bunu kullanır). Bunu bildirmeyen sağlayıcılar, değerin elendiğinin görülebilmesi için araç sonucunda details.ignoredOverrides üzerinden değeri gösterir.

Gelişmiş

"generate" | "status" | "list"
varsayılan:"generate"
"status" geçerli oturum görevini döndürür; "list" sağlayıcıları inceler.
string
Sağlayıcı/model geçersiz kılma değeri (ör. runway/gen4.5).
string
Çıktı dosya adı ipucu.
number
Milisaniye cinsinden isteğe bağlı sağlayıcı işlemi zaman aşımı. Atlandığında OpenClaw, yapılandırılmışsa agents.defaults.mediaModels.video.timeoutMs değerini; aksi takdirde varsa plugin yazarı tarafından belirlenen sağlayıcı varsayılanını kullanır.
object
JSON nesnesi olarak sağlayıcıya özgü seçenekler (ör. {"seed": 42, "draft": true}). Türü belirlenmiş bir şema bildiren sağlayıcılar anahtarları ve türleri doğrular; bilinmeyen anahtarlar veya uyuşmazlıklar, geri dönüş sırasında adayın atlanmasına neden olur. Bildirilmiş şeması olmayan sağlayıcılar seçenekleri değiştirilmeden alır. Her sağlayıcının neleri kabul ettiğini görmek için video_generate action=list komutunu çalıştırın.
Tüm sağlayıcılar tüm parametreleri desteklemez. OpenClaw süreyi sağlayıcının desteklediği en yakın değere normalleştirir ve geri dönüş sağlayıcısı farklı bir denetim yüzeyi sunduğunda boyuttan en-boy oranına gibi çevrilmiş geometri ipuçlarını yeniden eşler. Gerçekten desteklenmeyen geçersiz kılmalar, mümkün olan en iyi çaba temelinde yok sayılır ve araç sonucunda uyarı olarak bildirilir. Kesin yetenek sınırları (örneğin çok fazla referans girdisi) gönderimden önce başarısız olur. Araç sonuçları uygulanan ayarları bildirir; details.normalization, istenen değerden uygulanan değere yapılan tüm dönüşümleri yakalar.
Referans girdileri çalışma zamanı modunu seçer:
  • 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ır ve yalnızca maxInputAudios bildiren sağlayıcılarla çalışır.
Karışık görsel ve video referansları, kararlı ve ortak bir yetenek yüzeyi değildir. Her istek için tek bir referans türü tercih edin.

Geri dönüş ve türü belirlenmiş seçenekler

Bazı yetenek denetimleri araç sınırında değil, 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üş sağlayıcısında çalışabilir:
  • İstek ses referansları içerdiğinde, maxInputAudios (veya 0) bildirmeyen etkin aday atlanır; sonraki aday denenir. Aynı koruma, görsel ve video referansı sayılarında maxInputImages/maxInputVideos değerlerine göre uygulanır.
  • Etkin adayın maxDurationSeconds değeri istenen durationSeconds değerinden düşükse ve bildirilmiş bir supportedDurationSeconds listesi yoksa -> atlanır.
  • İstek providerOptions içeriyorsa ve etkin aday açıkça türü belirlenmiş bir providerOptions şeması bildiriyorsa, sağlanan anahtarlar şemada bulunmadığında veya değer türleri eşleşmediğinde -> atlanır. Bildirilmiş şeması olmayan sağlayıcılar seçenekleri değiştirilmeden alır (geriye dönük uyumlu doğrudan aktarım). 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 es geçildiğini görür. Uzun geri dönüş zincirlerini sessiz tutmak için sonraki atlamalar debug düzeyinde günlüğe kaydedilir. Her aday atlanırsa toplu hata, her birinin atlanma nedenini içerir.

Eylemler

Model seçimi

OpenClaw modeli şu sırayla çözümler:
  1. model araç parametresi - çağrıda agent bir tane belirtirse.
  2. Yapılandırmadaki videoGenerationModel.primary.
  3. Sırayla videoGenerationModel.fallbacks.
  4. Otomatik algılama - geçerli kimlik doğrulaması olan sağlayıcılar; önce geçerli varsayılan sağlayıcı, 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. Kimliği doğrulanmış sağlayıcılar arasında otomatik geri dönüş her zaman etkindir. Çağrı başına model değeri belirleyici olmaya devam eder.

Sağlayıcı notları

DashScope / Model Studio eşzamansız uç noktasını kullanır. Referans görseller ve videolar uzak http(s) URL’leri olmalıdır.
Sağlayıcı kimliği: byteplus.Modeller: seedance-1-0-pro-250528 (varsayılan), seedance-1-5-pro-251215.Birleşik content[] API’sini kullanır. En fazla 2 giriş görselini destekler (first_frame + last_frame). Görselleri konum sırasına göre iletin veya her görselin role değerini açıkça ayarlayın.Desteklenen providerOptions anahtarları: seed (sayı), draft (boolean - 480p’yi zorunlu kılar), camera_fixed (boolean).
@openclaw/byteplus-modelark plugin’ini gerektirir (harici, paketle birlikte gelmez). Sağlayıcı kimliği: byteplus-seedance15. Model: seedance-1-5-pro-251215.Birleşik content[] API’sini kullanır. En fazla 2 giriş görselini destekler (first_frame + last_frame). Tüm girdiler uzak https:// URL’leri olmalıdır. Her görselde role: "first_frame" / "last_frame" değerini ayarlayın veya görselleri konum sırasına göre iletin.aspectRatio: "adaptive", oranı giriş görselinden otomatik algılar. audio: true, generate_audio değerine eşlenir. providerOptions.seed (sayı) iletilir.
@openclaw/byteplus-modelark plugin’ini gerektirir (harici, paketle birlikte gelmez). Sağlayıcı kimliği: byteplus-seedance2. Modeller: dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128.Birleşik content[] API’sini kullanır. En fazla 9 referans görseli, 3 referans videoyu ve 3 referans sesi destekler. Tüm girdiler uzak https:// URL’leri olmalıdır. Her varlıkta role değerini ayarlayın - desteklenen değerler: "first_frame", "last_frame", "reference_image", "reference_video", "reference_audio".aspectRatio: "adaptive", oranı giriş görselinden otomatik algılar. audio: true, generate_audio değerine eşlenir. providerOptions.seed (sayı) iletilir.
İş akışı odaklı yerel veya bulut yürütmesi. Yapılandırılmış grafik aracılığıyla metinden videoya ve görüntüden videoya dönüştürmeyi destekler.
Uzun süren işler için kuyruk destekli bir akış kullanır. OpenClaw, devam eden bir fal kuyruk işini zaman aşımına uğramış saymadan önce varsayılan olarak 20 dakikaya kadar bekler. Çoğu fal video modeli tek bir görüntü referansı kabul eder. Seedance 2.0 referanstan videoya modelleri, toplamda en fazla 12 referans dosyası olmak üzere en çok 9 görüntü, 3 video ve 3 ses referansı kabul eder.
Bir görüntü veya bir video referansını destekler. Gemini API yolu, mevcut Veo video üretiminde generateAudio parametresini reddettiği için oluşturulmuş ses istekleri bir uyarıyla yok sayılır.
Yalnızca tek görüntü referansı. MiniMax, 768P ve 1080P çözünürlüklerini kabul eder; 720P gibi istekler gönderilmeden önce desteklenen en yakın değere normalleştirilir.
Yalnızca size geçersiz kılması iletilir. Diğer stil geçersiz kılmaları (aspectRatio, resolution, audio, watermark) bir uyarıyla yok sayılır.
OpenRouter’ın eşzamansız /videos API’sini kullanır. OpenClaw işi gönderir, polling_url durumunu yoklar ve unsigned_urls ya da belgelenmiş iş içeriği uç noktasını indirir. Paketle gelen varsayılan google/veo-3.1-fast; 4/6/8 saniyelik süreleri, 720P/1080P çözünürlüklerini ve 16:9/9:16 en-boy oranlarını bildirir.
Alibaba ile aynı DashScope arka ucunu kullanır. Referans girdileri uzak http(s) URL’leri olmalıdır; yerel dosyalar en başta reddedilir.
Veri URI’leri aracılığıyla yerel dosyaları destekler. Videodan videoya dönüştürme runway/gen4_aleph gerektirir. Yalnızca metin içeren çalıştırmalar, 16:9 ve 9:16 en-boy oranlarını sunar.
Yalnızca tek görüntü referansı.
Kimlik doğrulamasını düşüren yönlendirmelerden kaçınmak için doğrudan https://www.vydra.ai/api/v1 kullanır. veo3 yalnızca metinden videoya olarak paketle gelir; kling uzak bir görüntü URL’si gerektirir.
Varsayılan grok-imagine-video modeli; metinden videoya, tek ilk kareli görüntüden videoya, xAI reference_images aracılığıyla en fazla 7 reference_image girdisi ve uzak video düzenleme/uzatma akışlarını destekler. Üretim varsayılan olarak 480P değerini kullanır; aspectRatio belirtilmediğinde tek görüntülü görüntüden videoya dönüştürme, kaynak oranını devralır. Video düzenleme/uzatma, girdi geometrisini devralır ve en-boy oranı veya çözünürlük geçersiz kılmalarını kabul etmez. Uzatma 2-10 saniye kabul eder.grok-imagine-video-1.5 yalnızca görüntüden videoya dönüştürme içindir: tam olarak bir görüntü sağlayın. 1-15 saniyeyi ve 480P, 720P veya 1080P değerlerini destekler; varsayılan değer 480P olur. Kaynak görüntü oranını devralmak için aspectRatio değerini belirtmeyin. Önizleme ve tarihli 1.5 tanımlayıcıları aynı doğrulamadan geçirilir ve değiştirilmeden iletilir.

Sağlayıcı yetenek modları

Paylaşılan video üretim 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:
maxInputImages ve maxInputVideos gibi düz toplu alanlar, dönüştürme modu desteğini bildirmek için yeterli değildir. Sağlayıcılar; canlı testlerin, sözleşme testlerinin ve paylaşılan video_generate aracının mod desteğini belirleyici biçimde doğrulayabilmesi için generate, imageToVideo ve videoToVideo değerlerini 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 paketli sağlayıcılar için isteğe bağlı canlı kapsam:
Repo sarmalayıcısı:
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 hızlı test çalıştırır:
  • generate taramadaki FAL dışındaki her sağlayıcı için.
  • Bir saniyelik ıstakoz istemi.
  • Sağlayıcı başına işlem sınırı: OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (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:
Paylaşılan taramanın yerel medya ile güvenle ç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.
Günümüzde paylaşılan videoToVideo canlı hattı, yalnızca runway/gen4_aleph seçildiğinde runway kapsamını sağlar.

Yapılandırma

OpenClaw yapılandırmanızda varsayılan video üretim modelini ayarlayın:
Veya CLI aracılığıyla:

İlgili