Pembuatan video

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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg Batas waktu operasi penyedia opsional dalam milidetik. Jika dihilangkan, OpenClaw menggunakan agents.defaults.videoGenerationModel.timeoutMs jika dikonfigurasi, atau nilai bawaan penyedia yang ditentukan oleh pembuat plugin jika tersedia. OPENCLAW_DOCS_MARKER:paramClose:

Masukan referensi memilih mode waktu proses:

• Tanpa media referensi -> generate
• Referensi gambar apa pun -> imageToVideo
• Referensi video apa pun -> videoToVideo
• Masukan audio referensi tidak mengubah mode yang ditetapkan; masukan tersebut diterapkan di atas mode apa pun yang dipilih oleh referensi gambar/video, dan hanya berfungsi dengan penyedia yang mendeklarasikan maxInputAudios.

Campuran referensi gambar dan video bukanlah permukaan kapabilitas bersama yang stabil. Utamakan satu jenis referensi per permintaan.

Fallback dan opsi bertipe

Beberapa pemeriksaan kapabilitas berlaku pada lapisan fallback, bukan pada batas alat, sehingga permintaan yang melampaui batas penyedia utama masih dapat dijalankan pada fallback yang kapabel:

• Kandidat aktif yang tidak mendeklarasikan maxInputAudios (atau 0) akan dilewati ketika permintaan berisi referensi audio; kandidat berikutnya akan dicoba. Pemeriksaan yang sama berlaku untuk jumlah referensi gambar dan video terhadap maxInputImages/maxInputVideos.
• maxDurationSeconds kandidat aktif yang lebih rendah daripada 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 nilainya 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 kandidat dilewati seperti pada ketidakcocokan tipe.

Alasan pelewatan pertama dalam suatu permintaan dicatat pada tingkat warn agar operator mengetahui kapan penyedia utama mereka dilewati; pelewatan berikutnya dicatat pada tingkat debug untuk menjaga agar rantai fallback yang panjang tidak bising. Jika setiap kandidat dilewati, kesalahan gabungan menyertakan alasan pelewatan untuk masing-masing kandidat.

Tindakan

Pemilihan model

OpenClaw menetapkan model dengan urutan berikut:

1. Parameter alat model - jika agen menentukannya dalam panggilan.
2. videoGenerationModel.primary dari konfigurasi.
3. videoGenerationModel.fallbacks sesuai urutan.
4. Deteksi otomatis - penyedia yang memiliki autentikasi valid, dimulai dari penyedia bawaan saat ini, lalu penyedia lainnya dalam urutan alfabet.

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

Tetapkan agents.defaults.mediaGenerationAutoProviderFallback: false untuk hanya menggunakan 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"],        timeoutMs: 180000, // penggantian batas waktu permintaan penyedia per alat yang opsional      },    },  },}

Catatan penyedia

Mode kapabilitas penyedia

Kontrak bersama pembuatan video mendukung kapabilitas khusus mode, bukan hanya batas agregat datar. Implementasi penyedia baru sebaiknya mengutamakan 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 menyatakan 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 suatu penyedia memiliki dukungan input referensi yang lebih luas daripada model lainnya, gunakan maxInputImagesByModel, maxInputVideosByModel, atau maxInputAudiosByModel alih-alih menaikkan batas untuk seluruh mode.

Pengujian langsung

Cakupan langsung opsional untuk penyedia bersama bawaan:

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

Pembungkus repo:

pnpm test:live:media video

Secara default, berkas pengujian langsung ini menggunakan variabel lingkungan penyedia yang sudah diekspor sebelum profil autentikasi tersimpan, dan menjalankan pengujian singkat yang aman untuk rilis:

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

FAL bersifat opsional karena latensi antrean di sisi penyedia dapat mendominasi waktu rilis:

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

Tetapkan OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1 untuk turut menjalankan mode transformasi yang dideklarasikan dan dapat dijalankan dengan aman oleh rangkaian bersama menggunakan media lokal:

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

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

Konfigurasi

Tetapkan model pembuatan video default dalam 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