Panduan Flova CLI untuk Agen AI

Flova CLI memungkinkan Anda menggunakan Flova dari Agent eksternal seperti Codex dan Claude Code. Cukup salin Prompt setup ke Agent yang Anda gunakan; Agent akan menginstal dan memuat Flova CLI serta Flova Skill, terhubung ke akun Flova Anda, lalu membantu Anda membuat proyek, menjalankan generasi, membaca status proyek, dan mengekspor video final dengan bahasa natural.

Ini tidak sama dengan menggunakan Flova sebagai API tunggal untuk menghasilkan gambar atau video. Flova CLI terhubung ke sistem proyek Flova yang lengkap: kebutuhan proyek, riwayat chat, storyboard, media, dokumen, dan timeline semuanya tetap berada dalam proyek yang sama. Agent eksternal berbicara dengan Anda, memanggil CLI, dan melaporkan progres; Flova terus mendorong proses pembuatan video di dalam proyek.

Kapan digunakan

Gunakan Flova CLI saat Anda sudah terbiasa bekerja di Codex, Claude Code, atau lingkungan Agent lain dan ingin Agent tersebut ikut dalam pembuatan video. Misalnya:

• Bekerja di Codex pada skrip, referensi, atau catatan produk sambil meminta Flova membuat proyek video.
• Meminta Claude Code memanggil Flova untuk menghasilkan storyboard, media, dan edit final dari permintaan bahasa natural Anda.
• Membiarkan Agent eksternal membaca status proyek Flova yang sebenarnya, bukan menjelaskan progres dari ingatan.
• Untuk tugas generasi atau ekspor yang lama, biarkan Agent terus memantau status tugas dan melaporkan tautan proyek serta hasil final ketika selesai.

Cara setup

Buka halaman Flova CLI di Flova, lalu serahkan Flova kepada Agent yang Anda gunakan:

Salin Prompt setup

Kirim teks di bawah ini ke AI Agent yang Anda gunakan. Agent akan menginstal dan memuat Flova CLI dan Skill, memandu Anda masuk, lalu terus membuat dengan Flova Skill.

Contoh:

Bantu saya menginstal Flova CLI: https://cli.flova.ai/flovaCLI-setup.md

Jelaskan video yang Anda inginkan

Jelaskan video seperti saat Anda berbicara normal dengan AI. Sertakan tujuan video, durasi, rasio aspek, gaya, konten utama, dan ekspektasi pengiriman final. Jika ingin memilih Flova Skill yang tepat terlebih dahulu, minta Agent merekomendasikan opsi sebelum membuat proyek.

Contoh:

Gunakan Flova untuk membuat film pendek naratif fantasi yang hangat berdurasi 30 detik, 16:9:Pada malam saat listrik padam, robot kecil yang tinggal di atap kota menemukan biji yang bercahaya dan melewati berbagai rintangan untuk memberikannya kepada seorang gadis kecil yang tersesat di lantai bawah.Alurnya harus jelas: 5 detik pertama membangun suasana listrik padam dan memperkenalkan robot, bagian tengah menunjukkan proses robot mengantarkan biji, dan akhir menampilkan kota yang menyala kembali.Sebelum produksi dimulai, rekomendasikan 2-3 Flova Skills yang cocok, jelaskan alasan masing-masing cocok, lalu tunggu saya memilih sebelum membuat proyek.

Pilih dan terus tinjau

Saat proyek berjalan, Anda dapat meninjau pekerjaan, memberi masukan, dan memberi tahu Agent apa yang sudah disetujui serta apa yang perlu diubah berikutnya.

Contoh:

Storyboard secara keseluruhan disetujui, tetapi shot ketiga terlalu gelap. Sesuaikan hanya shot ketiga, jangan ubah desain karakter yang sudah dikonfirmasi, lalu lanjutkan produksi setelah penyesuaian selesai.

Agent mengikuti Prompt setup untuk menginstal Flova CLI dan membaca Flova Skill, yang menjelaskan cara membuat proyek, mengunggah materi, mengirim instruksi kreatif, menunggu hasil generasi, membaca status proyek, dan mengekspor video.

Dalam sebagian besar kasus, Agent terhubung ke akun Flova Anda melalui alur masuk browser. Agent membuka halaman otorisasi; setelah Anda masuk ke Flova dan menyetujui permintaan, CLI lokal dapat melanjutkan dengan izin akun Anda.

Jika Agent tidak dapat membuka browser, atau jika Anda ingin memberi otorisasi langsung kepada Agent eksternal, Anda dapat membuat Agent API Key dari halaman Flova atau pengaturan akun dan memberikannya melalui kanal aman. API Key memberi akses ke akun Flova Anda, jadi perlakukan seperti kata sandi. Anda dapat mencabutnya kapan pun tidak lagi diperlukan.

Apa yang bisa dilakukan Agent

Setelah setup, Agent eksternal dapat menggunakan Flova CLI untuk:

• Membuat proyek baru atau melanjutkan proyek yang sudah ada.
• Mengunggah gambar, video, audio, atau dokumen sebagai materi proyek.
• Mengirim instruksi kreatif bahasa natural ke Flova agar Flova memajukan storyboard, generasi media, audio, timeline, dan persiapan ekspor.
• Membaca storyboard, media, dokumen, riwayat chat, dan status ekspor proyek.
• Terus memeriksa status tugas selama generasi atau ekspor, dan memulihkan pemantauan lokal jika terputus.
• Memulai ekspor saat video siap, lalu melaporkan tautan proyek, video final, dan status saat ini.

Hubungan dengan aplikasi web Flova

Proyek yang dibuat atau dilanjutkan melalui CLI tetap merupakan proyek Flova biasa. Anda dapat kembali ke aplikasi web Flova kapan saja untuk meninjau storyboard, Media Space, Docs panel, dan Timeline, atau melanjutkan pengeditan langsung di aplikasi web.

Hal yang sama berlaku sebaliknya: Agent eksternal dapat melanjutkan pekerjaan pada proyek web yang sudah ada. Agent membaca status proyek saat ini, lalu melanjutkan berdasarkan storyboard, media, dokumen, dan kesiapan ekspor yang sebenarnya.

Tips penggunaan

• Beri tahu Agent tujuan video, durasi, rasio aspek, gaya, poin penting, materi yang sudah ada, dan ekspektasi pengiriman final.
• Hindari hanya mengatakan “lanjutkan generasi”. Lebih baik jelaskan tahap saat ini dan langkah berikutnya, misalnya menyempurnakan storyboard terlebih dahulu, membuat keyframe terlebih dahulu, atau mengekspor setelah timeline siap.
• Minta Agent membaca status proyek sebelum melaporkan progres, agar tidak menebak dari percakapan sebelumnya.
• Bagikan API Keys hanya kepada Agent yang Anda percaya. Jangan masukkan ke kode, log, atau dokumen bersama.
• Untuk tugas generasi atau ekspor yang lama, jangan anggap interupsi CLI lokal sebagai kegagalan proyek. Tugas backend Flova mungkin masih berjalan, dan Agent dapat memulihkan progres melalui CLI.