Video Oluşturma
OpenClaw aracıları metin istemlerinden, referans görsellerden veya mevcut videolardan video oluşturabilir. On iki sağlayıcı arka ucu desteklenir; her birinin farklı model seçenekleri, giriş modları ve özellik setleri vardır. Aracı, yapılandırmanıza ve kullanılabilir API anahtarlarına göre doğru sağlayıcıyı otomatik olarak seçer.
video_generate aracı yalnızca en az bir video oluşturma sağlayıcısı kullanılabilir olduğunda görünür. Aracı araçlarınızda görmüyorsanız bir sağlayıcı API anahtarı ayarlayın veya agents.defaults.videoGenerationModel yapılandırın.
Hızlı başlangıç
- Desteklenen herhangi bir sağlayıcı için bir API anahtarı ayarlayın:
export GEMINI_API_KEY="your-key"
- İsteğe bağlı olarak bir varsayılan model sabitleyin:
openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"
- Aracıya sorun:
Gün batımında sörf yapan dost canlısı bir ıstakozun 5 saniyelik sinematik bir videosunu oluştur.
Aracı video_generate aracını otomatik olarak çağırır. Araç izin listesi gerekmez.
Bir video oluşturduğunuzda ne olur
Video oluşturma eşzamansızdır. Aracı bir oturumda video_generate çağırdığında:
- 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 (genellikle sağlayıcıya ve çözünürlüğe bağlı olarak 30 saniye ile 5 dakika arasında).
- Video hazır olduğunda OpenClaw aynı oturumu dahili bir tamamlanma olayıyla uyandırır.
- Aracı tamamlanan videoyu özgün konuşmaya geri 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. İlerlemeyi CLI üzerinden kontrol etmek için openclaw tasks list veya openclaw tasks show <taskId> kullanın.
Oturum destekli aracı çalıştırmaları dışında (örneğin doğrudan araç çağrıları), araç satır içi oluşturmaya geri döner ve son medya yolunu aynı turda döndürür.
Desteklenen sağlayıcılar
| Sağlayıcı | Varsayılan model | Metin | Görsel ref | Video ref | API anahtarı |
|---|
| Alibaba | wan2.6-t2v | Evet | Evet (uzak URL) | Evet (uzak URL) | MODELSTUDIO_API_KEY |
| BytePlus | seedance-1-0-lite-t2v-250428 | Evet | 1 görsel | Hayır | BYTEPLUS_API_KEY |
| ComfyUI | workflow | Evet | 1 görsel | Hayır | COMFY_API_KEY veya COMFY_CLOUD_API_KEY |
| fal | fal-ai/minimax/video-01-live | Evet | 1 görsel | Hayır | FAL_KEY |
| Google | veo-3.1-fast-generate-preview | Evet | 1 görsel | 1 video | GEMINI_API_KEY |
| MiniMax | MiniMax-Hailuo-2.3 | Evet | 1 görsel | Hayır | MINIMAX_API_KEY |
| OpenAI | sora-2 | Evet | 1 görsel | 1 video | OPENAI_API_KEY |
| Qwen | wan2.6-t2v | Evet | Evet (uzak URL) | Evet (uzak URL) | QWEN_API_KEY |
| Runway | gen4.5 | Evet | 1 görsel | 1 video | RUNWAYML_API_SECRET |
| Together | Wan-AI/Wan2.2-T2V-A14B | Evet | 1 görsel | Hayır | TOGETHER_API_KEY |
| Vydra | veo3 | Evet | 1 görsel (kling) | Hayır | VYDRA_API_KEY |
| xAI | grok-imagine-video | Evet | 1 görsel | 1 video | XAI_API_KEY |
video_generate action=list çalıştırın.
Araç parametreleri
Zorunlu
| Parametre | Tür | Açıklama |
|---|
prompt | string | Oluşturulacak videonun metin açıklaması (action: "generate" için zorunludur) |
İçerik girdileri
| Parametre | Tür | Açıklama |
|---|
image | string | Tek referans görseli (yol veya URL) |
images | string[] | Birden çok referans görseli (en fazla 5) |
video | string | Tek referans videosu (yol veya URL) |
videos | string[] | Birden çok referans videosu (en fazla 4) |
Stil denetimleri
| Parametre | Tür | Açıklama |
|---|
aspectRatio | string | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 |
resolution | string | 480P, 720P veya 1080P |
durationSeconds | number | Hedef süre saniye cinsinden (sağlayıcının desteklediği en yakın değere yuvarlanır) |
size | string | Sağlayıcı desteklediğinde boyut ipucu |
audio | boolean | Desteklendiğinde oluşturulan sesi etkinleştirir |
watermark | boolean | Desteklendiğinde sağlayıcı filigranını açıp kapatır |
Gelişmiş
| Parametre | Tür | Açıklama |
|---|
action | string | "generate" (varsayılan), "status" veya "list" |
model | string | Sağlayıcı/model geçersiz kılması (ör. runway/gen4.5) |
filename | string | Çıktı dosya adı ipucu |
Eylemler
- generate (varsayılan) — verilen istem ve isteğe bağlı referans girdilerinden bir video oluşturur.
- status — başka bir oluşturma başlatmadan mevcut oturum için devam eden video görevinin durumunu denetler.
- list — kullanılabilir sağlayıcıları, modelleri ve yeteneklerini gösterir.
Model seçimi
Bir video oluşturulurken OpenClaw modeli şu sırayla çözümler:
model araç parametresi — aracı çağrıda bir tane belirtirse.videoGenerationModel.primary — yapılandırmadan.videoGenerationModel.fallbacks — sırayla denenir.- Otomatik algılama — geçerli kimlik doğrulaması olan sağlayıcıları kullanır; önce geçerli varsayılan sağlayıcıdan, ardından kalan sağlayıcılardan alfabetik sırayla başlar.
Bir sağlayıcı başarısız olursa sıradaki aday otomatik olarak denenir. Tüm adaylar başarısız olursa hata her denemeden ayrıntılar içerir.
{
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ı | Notlar |
|---|
| 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 | Yalnızca tek görsel referansı. |
| ComfyUI | İş akışı odaklı yerel veya bulut yürütme. Yapılandırılmış grafik üzerinden metinden videoya ve görselden videoya desteği sunar. |
| fal | Uzun süreli işler için kuyruk destekli akış kullanır. Yalnızca tek görsel referansı. |
| Google | Gemini/Veo kullanır. Bir görsel veya bir video referansını destekler. |
| MiniMax | Yalnızca tek görsel referansı. |
| OpenAI | Yalnızca size geçersiz kılması iletilir. Diğer stil geçersiz kılmaları (aspectRatio, resolution, audio, watermark) uyarıyla yok sayılır. |
| Qwen | Alibaba ile aynı DashScope arka ucunu kullanır. Referans girdileri uzak http(s) URL’leri olmalıdır; yerel dosyalar peşinen reddedilir. |
| Runway | Data URI’leri üzerinden yerel dosyaları destekler. Videodan videoya için runway/gen4_aleph gerekir. Yalnızca metinli çalıştırmalar 16:9 ve 9:16 en-boy oranlarını sunar. |
| Together | Yalnızca tek görsel referansı. |
| Vydra | Kimlik doğrulamayı düşüren yönlendirmeleri önlemek için doğrudan https://www.vydra.ai/api/v1 kullanır. veo3 yalnızca metinden videoya olarak paketlenir; kling uzak bir görsel URL’si gerektirir. |
| xAI | Metinden videoya, görselden videoya ve uzak video düzenleme/uzatma akışlarını destekler. |
Yapılandırma
Varsayılan video oluşturma modelini OpenClaw yapılandırmanızda ayarlayın:
{
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
