AI Video

Step AI Video mengirim prompt ke provider, menunggu proses pembuatan video, lalu menyimpan hasilnya di Media library. Proses ini biasanya memerlukan beberapa menit. Biaya dibebankan langsung oleh provider berdasarkan akun dan model yang kamu gunakan.

Video yang dihasilkan dapat diunduh melalui Media. Video dari Media library belum dapat dilampirkan langsung ke step Posting.

Menghubungkan provider video

Dua jenis connection dapat digunakan dengan AI Video. Buka Connections → Add a connection:

• OpenAI-compatible: gunakan OpenRouter (https://openrouter.ai/api/v1) dan isi Default video model yang opsional, misalnya google/veo-3.1. Server lain harus menyediakan API /videos yang kompatibel dengan integrasi ini. Jika API tidak sesuai, step gagal dengan pesan dari server.
• Higgsfield: masukkan API key ID dan API key secret dari akun Higgsfield kamu, dan opsional Default video model, yaitu path endpoint Higgsfield seperti wan/v2.7/text-to-video. Alur tidak dapat memeriksa key ke Higgsfield saat disimpan, jadi key yang salah baru terlihat saat step pertama kali dijalankan. Kedua bagian disimpan terenkripsi dan tidak pernah ditampilkan lagi. Update key mengganti kedua bagian tanpa mengubah referensi pada step.
• HeyGen: masukkan API key HeyGen kamu. Prompt dikirim ke Video Agent HeyGen, yang memilih sendiri avatar, suara, dan durasi, jadi tulis apa yang harus diucapkan dan ditampilkan video di prompt. Video memakai kredit HeyGen kamu. Alur tidak dapat memeriksa key saat disimpan, jadi key yang salah baru terlihat saat step pertama kali dijalankan. Disimpan terenkripsi.

Menambah step AI Video

1. Di editor workflow, tekan +.
2. Pilih AI Video (di bawah AI). Salah satu connection yang mendukung video dipilih secara otomatis. Kamu dapat menggantinya melalui pengaturan step.
3. Isi kolom di bawah.

Setiap kolom menerima expression {{ <stepId>.<path> }}, seperti step lainnya.

Kolom	Catatan
Connection	wajib; provider yang dipanggil step ini
Prompt	wajib; deskripsikan videonya, biasanya dengan data dari step sebelumnya

Bagian Advanced dapat dibuka untuk mengatur opsi berikut:

Kolom	Catatan
Model	kosong menggunakan model video default connection. Untuk Higgsfield ini adalah path endpoint
Seconds	panjang video, bilangan bulat. Kosong menggunakan default provider
Resolution	misalnya 720p atau 1080p. Kosong menggunakan default provider
Aspect ratio	misalnya 16:9 atau 9:16. Kosong menggunakan default provider

Yang dikosongkan tidak dikirim. Nilai yang diizinkan bergantung pada model. Setiap Run membuat satu video.

Menunggu hasil video

Setelah permintaan diterima, Run menampilkan step sebagai berjalan selagi provider bekerja. Alur meminta provider memanggil balik saat video siap, jadi video yang selesai biasanya langsung terdeteksi. Alur juga memeriksa status provider setelah 30 detik, lalu semenit, lalu setiap dua menit, sehingga hasil tetap dapat diperiksa meskipun callback tidak diterima. Penantian ini bertahan saat restart dan tidak menggunakan step workflow kamu yang lain.

Jika video belum siap setelah sekitar 20 menit, step gagal dan pesannya menyertakan job ID dari provider. Provider mungkin masih menyelesaikan dan menagih video itu; Alur hanya berhenti menunggu.

Output dan kegagalan

Jika berhasil, video menjadi file baru di Media library kamu dan output step berisi:

• fileId: ID file, misalnya {{ step1.fileId }}
• mediaType: misalnya video/mp4
• name: nama file yang diberikan Alur, seperti ai-video-1a2b3c4d.mp4
• size: ukuran file dalam byte
• model: model yang diminta
• jobId: job ID dari provider

Permintaan yang ditolak (key salah, model tidak dikenal, saldo habis), job yang dilaporkan gagal atau ditolak provider (misalnya karena kebijakan konten), job selesai tanpa video, atau video yang melebihi batas Media 25 MB menggagalkan step dengan pesan yang jelas, dan detail Run menampilkan pesan tersebut. Alur tidak mengulang kegagalan ini, karena percobaan berikutnya dapat dikenai biaya tambahan. Hanya rate limit (HTTP 429) dan error jaringan yang diulang saat permintaan dikirim, dan jika provider sementara tidak tersedia saat pemeriksaan status, Alur menunggu pemeriksaan berikutnya.

Alur tidak menjamin permintaan hanya terjadi sekali bila ada kegagalan di tengah, dan setiap video ditagih oleh provider kamu. Dalam loop For each, setiap item menghasilkan satu video, satu per satu, jadi daftar panjang memakan waktu lama dan berarti satu video per item; pengaturan step menampilkan peringatan bila step berada di dalam For each, dan satu loop hanya boleh berisi satu step AI Video.

Hapus video hasil yang tidak lagi kamu perlukan dari Media.