Pembuatan video

"status" mengembalikan tugas sesi saat ini; "list" memeriksa penyedia.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg Timeout operasi penyedia opsional dalam milidetik. Jika dihilangkan, OpenClaw menggunakan agents.defaults.videoGenerationModel.timeoutMs jika dikonfigurasi. OPENCLAW_DOCS_MARKER:paramClose:

Input referensi memilih mode runtime:

• Tidak ada media referensi → generate
• Referensi gambar apa pun → imageToVideo
• Referensi video apa pun → videoToVideo
• Input audio referensi tidak mengubah mode yang diselesaikan; input tersebut diterapkan di atas mode apa pun yang dipilih referensi gambar/video, dan hanya berfungsi dengan penyedia yang mendeklarasikan maxInputAudios.

Referensi gambar dan video campuran bukan permukaan kapabilitas bersama yang stabil. Pilih satu jenis referensi per permintaan.

Fallback dan opsi bertipe

Beberapa pemeriksaan kapabilitas diterapkan di lapisan fallback, bukan di batas alat, sehingga permintaan yang melampaui batas penyedia utama masih dapat berjalan pada fallback yang mampu:

• Kandidat aktif yang tidak mendeklarasikan maxInputAudios (atau 0) dilewati ketika permintaan berisi referensi audio; kandidat berikutnya dicoba.
• maxDurationSeconds kandidat aktif di bawah durationSeconds yang diminta tanpa daftar supportedDurationSeconds yang dideklarasikan → dilewati.
• Permintaan berisi providerOptions dan kandidat aktif secara eksplisit mendeklarasikan skema providerOptions bertipe → dilewati jika kunci yang diberikan tidak ada dalam skema atau tipe nilai tidak cocok. Penyedia tanpa skema yang dideklarasikan menerima opsi apa adanya (penerusan yang kompatibel ke belakang). Penyedia dapat menolak semua opsi penyedia dengan mendeklarasikan skema kosong (capabilities.providerOptions: {}), yang menyebabkan pelewatan yang sama seperti ketidakcocokan tipe.

Alasan pelewatan pertama dalam permintaan dicatat pada warn agar operator melihat ketika penyedia utama mereka dilewati; pelewatan berikutnya dicatat pada debug untuk menjaga rantai fallback yang panjang tetap senyap. Jika setiap kandidat dilewati, error agregat menyertakan alasan pelewatan untuk masing-masing.

Tindakan

Pemilihan model

OpenClaw menyelesaikan model dalam urutan ini:

1. Parameter alat model - jika agen menentukannya dalam panggilan.
2. videoGenerationModel.primary dari config.
3. videoGenerationModel.fallbacks secara berurutan.
4. Deteksi otomatis - penyedia yang memiliki auth valid, dimulai dengan penyedia default saat ini, lalu penyedia yang tersisa dalam urutan alfabetis.

Jika penyedia gagal, kandidat berikutnya dicoba secara otomatis. Jika semua kandidat gagal, error menyertakan detail dari setiap percobaan.

Setel agents.defaults.mediaGenerationAutoProviderFallback: false untuk menggunakan hanya entri model, primary, dan fallbacks yang eksplisit.

{  agents: {    defaults: {      videoGenerationModel: {        primary: "google/veo-3.1-fast-generate-preview",        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],      },    },  },}

Catatan penyedia

Mode kapabilitas penyedia

Kontrak pembuatan video bersama mendukung kapabilitas khusus mode alih-alih hanya batas agregat datar. Implementasi penyedia baru sebaiknya memilih blok mode eksplisit:

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

Kolom agregat datar seperti maxInputImages dan maxInputVideos tidak cukup untuk mengiklankan dukungan mode transformasi. Penyedia sebaiknya mendeklarasikan generate, imageToVideo, dan videoToVideo secara eksplisit agar pengujian langsung, pengujian kontrak, dan alat bersama video_generate dapat memvalidasi dukungan mode secara deterministik.

Ketika satu model dalam sebuah penyedia memiliki dukungan input referensi yang lebih luas daripada yang lain, gunakan maxInputImagesByModel, maxInputVideosByModel, atau maxInputAudiosByModel alih-alih menaikkan batas untuk seluruh mode.

Pengujian langsung

Cakupan langsung ikut serta untuk penyedia bawaan bersama:

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

Pembungkus repo:

pnpm test:live:media video

File langsung ini memuat variabel lingkungan penyedia yang hilang dari ~/.profile, secara default memilih kunci API langsung/lingkungan sebelum profil autentikasi tersimpan, dan menjalankan uji dasar aman rilis secara default:

• generate untuk setiap penyedia non-FAL dalam penyapuan.
• Prompt lobster satu detik.
• Batas operasi per penyedia dari OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (180000 secara default).

FAL bersifat ikut serta karena latensi antrean sisi penyedia dapat mendominasi waktu rilis:

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

Atur OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1 untuk juga menjalankan mode transformasi yang dideklarasikan yang dapat dijalankan dengan aman oleh penyapuan bersama dengan media lokal:

• imageToVideo ketika capabilities.imageToVideo.enabled.
• videoToVideo ketika capabilities.videoToVideo.enabled dan penyedia/model menerima input video lokal berbasis buffer dalam penyapuan bersama.

Saat ini jalur langsung videoToVideo bersama mencakup runway hanya ketika Anda memilih runway/gen4_aleph.

Konfigurasi

Atur model pembuatan video default di konfigurasi OpenClaw Anda:

{  agents: {    defaults: {      videoGenerationModel: {        primary: "qwen/wan2.6-t2v",        fallbacks: ["qwen/wan2.6-r2v-flash"],      },    },  },}

Atau melalui CLI:

openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v"

Terkait

• Alibaba Model Studio
• Tugas latar belakang - pelacakan tugas untuk pembuatan video asinkron
• BytePlus
• ComfyUI
• Referensi konfigurasi
• fal
• Google (Gemini)
• MiniMax
• Model
• OpenAI
• Qwen
• Runway
• Together AI
• Ikhtisar alat
• Vydra
• xAI