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.
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:- OpenClaw, isteği sağlayıcıya gönderir ve hemen bir görev kimliği döndürür.
- 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).
- Video hazır olduğunda OpenClaw, aynı oturumu dahili bir tamamlanma olayıyla uyandırır.
- 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.
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 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
maxInputAudiosbildiren sağlayıcılarla çalışır.
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(veya0) bildirmeyen etkin aday atlanır; sonraki aday denenir. Aynı koruma, görsel ve video referansı sayılarındamaxInputImages/maxInputVideosdeğerlerine göre uygulanır. - Etkin adayın
maxDurationSecondsdeğeri istenendurationSecondsdeğerinden düşükse ve bildirilmiş birsupportedDurationSecondslistesi yoksa -> atlanır. - İstek
providerOptionsiçeriyorsa ve etkin aday açıkça türü belirlenmiş birproviderOptionsş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.
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:modelaraç parametresi - çağrıda agent bir tane belirtirse.- Yapılandırmadaki
videoGenerationModel.primary. - Sırayla
videoGenerationModel.fallbacks. - 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.
model değeri belirleyici olmaya devam eder.
Sağlayıcı notları
Alibaba
Alibaba
DashScope / Model Studio eşzamansız uç noktasını kullanır. Referans görseller
ve videolar uzak
http(s) URL’leri olmalıdır.BytePlus (paketle birlikte)
BytePlus (paketle birlikte)
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).BytePlus Seedance 1.5 plugin'i
BytePlus Seedance 1.5 plugin'i
@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.BytePlus Seedance 2.0
BytePlus Seedance 2.0
@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.ComfyUI
ComfyUI
İş 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.
fal
fal
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.
Google (Gemini / Veo)
Google (Gemini / Veo)
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.MiniMax
MiniMax
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.OpenAI
OpenAI
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
OpenRouter
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.Qwen
Qwen
Alibaba ile aynı DashScope arka ucunu kullanır. Referans girdileri uzak
http(s) URL’leri olmalıdır; yerel dosyalar en başta reddedilir.Runway
Runway
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.Together
Together
Yalnızca tek görüntü referansı.
Vydra
Vydra
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.xAI
xAI
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:generatetaramadaki 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 olarak180000).
OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1 ayarlayın:
capabilities.imageToVideo.enabledolduğundaimageToVideo.capabilities.videoToVideo.enabledolduğunda ve sağlayıcı/model, paylaşılan taramada arabellek destekli yerel video girdisini kabul ettiğindevideoToVideo.
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:İlgili
- Alibaba Model Studio
- Arka plan görevleri - eşzamansız video üretimi 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