Otomatisasi

Buat video dan hubungkan hasil yang sudah selesai ke alur kerja Anda melalui langganan penyelesaian Reela CLI.

Reela menyediakan perintah untuk produksi video dan langganan penyelesaian untuk video yang sudah selesai. Agen atau alat lain dapat mengirimkan brief dan menerima hasilnya melalui daemon CLI tanpa harus membiarkan situs web Reela tetap terbuka.

Dari brief menjadi videoSalin tautan jangkar

create mengubah brief teks dan media opsional menjadi tugas video. Anda dapat memberikan prompt secara langsung atau membacanya dari file, memilih durasi dan tata letak, menyertakan avatar, serta melampirkan gambar referensi, rekaman video, atau musik latar.

reela create --prompt-file brief.txt \
  --visual ai-video --layout portrait --duration 30 \
  --session "Product campaign" --output json

Pembuatan video adalah tugas yang berlangsung lama. Jalankan daemon dan konfigurasi langganan penyelesaian sebelum mengirimkan tugas; Reela menjalankan proses pembuatan di latar belakang dan mengirimkan hasil akhir ke skrip Anda. Menggunakan kembali judul sesi akan mengelompokkan video terkait ke dalam satu proyek. Lihat Pengiriman otomatis di bawah untuk penyiapan.

Sebelum mengirimkan tugas, tambahkan --dry-run untuk memvalidasi permintaan dan melihat pratinjau perkiraan kredit tanpa mengunggah file atau membuat tugas. Pengiriman tugas dapat menghabiskan kredit.

Lihat opsi pembuatan video untuk visual dan input media yang didukung.

Pilih kualitas dan biaya dengan tierSalin tautan jangkar

Tier memungkinkan Anda memilih opsi pembuatan untuk setiap permintaan. Reela memberikan deskripsi untuk membantu Anda atau agen memilih opsi yang sesuai dengan hasil yang diinginkan, lalu memperkirakan kredit untuk permintaan tersebut sebelum dikirimkan.

reela tiers list
reela tiers list --output json

Daftar ini menampilkan label dan deskripsi setiap tier serta menunjukkan tier default. Dalam output JSON, tiers berisi entri dengan label, content, dan is_default; default_tier menyebutkan tier default. Baca content untuk memahami setiap opsi, alih-alih memilih berdasarkan posisinya dalam daftar. Menampilkan daftar tier tidak menjamin bahwa akun Anda dapat menggunakan setiap opsi; Reela memeriksa akses saat memvalidasi atau mengirimkan permintaan.

Berikan label persisnya ke --tier. Ganti <tier-label> di bawah dengan label dari daftar Anda, dan pertahankan tanda kutip jika label tersebut berisi spasi:

reela create --prompt-file brief.txt --visual ai-video \
  --tier "<tier-label>" --duration 30 --layout portrait \
  --dry-run --output json

Pratinjau menampilkan credits_cost dan quota_after. Untuk mengirimkan tugas, hapus --dry-run dan pertahankan tier yang dipilih serta opsi lainnya. Tier menjelaskan pilihan pembuatan; gunakan pratinjau untuk memperkirakan biaya permintaan Anda yang sebenarnya.

Jika Anda tidak menyertakan --tier, Reela akan menggunakan default saat ini yang tersedia untuk CLI. Jika tidak ada default yang tersedia, jalankan reela tiers list untuk memperbarui pilihan atau tentukan tier secara eksplisit. Memilih tier secara eksplisit membuat pilihan alur kerja Anda tetap terpisah dari perubahan default; ketersediaan dan harga tetap dapat berubah. Gunakan profil yang sama untuk menampilkan daftar, melihat pratinjau, dan mengirimkan tugas.

Lihat referensi perintah tier untuk detail output dan perilaku pemilihan.

Hasil terstruktur untuk agen dan alatSalin tautan jangkar

--output json menyediakan hasil perintah, termasuk pilihan tier, perkiraan kredit, dan konfirmasi pengiriman, sebagai data terstruktur. Kode keluar 0 berarti perintah berhasil; kesalahan menggunakan kode keluar bukan nol dan teks biasa di stderr, termasuk dalam mode JSON.

Setelah pengiriman berhasil, daemon akan menunggu hingga proses selesai dan memanggil skrip langganan Anda dengan hasilnya. Respons pengiriman dan peristiwa penyelesaian menyertakan task_id agar alur kerja Anda dapat mengaitkan video yang sudah selesai dengan brief asalnya.

Pengiriman otomatisSalin tautan jangkar

Reela CLI dapat menjalankan file executable Anda sendiri saat tugas video selesai. Langganan penyelesaian ini menghubungkan output Reela dengan tindakan Anda berikutnya: meneruskan video ke alat publikasi, memperbarui catatan, atau memberi tahu sistem lain. Reela memantau penyelesaian dan memberikan detail tugas kepada skrip Anda.

Daftarkan skrip AndaSalin tautan jangkar

Berikan jalur absolut ke file executable di komputer yang menjalankan Reela CLI. File tersebut dapat menggunakan bahasa apa pun selama membaca peristiwa dari stdin dan melaporkan keberhasilan melalui kode keluarnya.

reela subscribe add script --path /absolute/path/on-video \
  --timeout-seconds 300 --max-retries 3

Setiap profil memiliki satu langganan skrip. Untuk mengubah file executable pada langganan yang sudah ada, gunakan reela config set delivery.script.path /absolute/path/on-video. Mulai ulang daemon yang sedang berjalan setelah mengubah langganan atau pengaturannya, seperti dijelaskan di bawah.

Terima peristiwa penyelesaianSalin tautan jangkar

Reela menjalankan file executable dan menulis satu objek JSON ke stdin:

{
  "event": "task.completed",
  "task_id": "12345",
  "status": "completed",
  "status_label": "completed",
  "title": "Product demo",
  "description": "A short product introduction",
  "download": {
    "filename": "product-demo.mp4",
    "download_url": "https://example.com/video.mp4"
  }
}

Gunakan task_id untuk menghubungkan peristiwa dengan pengiriman awal Anda. title, description, dan download dapat berupa null. Jika tersedia, download memberikan nama file yang disarankan dan URL unduhan video yang sudah selesai agar dapat langsung digunakan oleh skrip Anda. Tangani nilai download yang tidak tersedia sebelum menjalankan tindakan yang memerlukan video tersebut.

Tautan download_url bertanda tangan kedaluwarsa 6 jam setelah dibuat. Unduh atau salin video ke penyimpanan Anda sendiri segera setelah menerima peristiwa penyelesaian. Jaga kerahasiaan URL unduhan dan perlakukan URL tersebut sebagai tautan akses sementara, bukan alamat video permanen.

Langganan menerima tugas yang selesai untuk akun yang dipilih, termasuk video yang dibuat di luar CLI. Jika tindakan Anda terkait dengan alur kerja tertentu, cocokkan ID tugas dalam peristiwa dengan tugas yang Anda kirimkan. Saat ini, langganan penyelesaian hanya menangani tugas yang berhasil diselesaikan; tugas yang gagal, dibatalkan, atau selesai sebagian tidak memicu peristiwa ini.

Eksekusi dan percobaan ulangSalin tautan jangkar

• Berhasil: keluar dengan 0 setelah tindakan Anda berhasil. Reela membuang stdout skrip; output yang dicetak tidak digunakan sebagai hasil.
• Batas waktu: --timeout-seconds 300 mengizinkan setiap pemanggilan berlangsung hingga 300 detik. Batas waktu yang terlampaui atau kode keluar bukan nol akan menyebabkan pengiriman gagal.
• Percobaan ulang: Reela mengulangi pengiriman yang gagal. Jika hanya metode skrip yang gagal, --max-retries 3 mengizinkan total tiga percobaan, termasuk percobaan pertama. Kegagalan yang melibatkan metode lain yang diaktifkan menggunakan delivery.max_retries.
• Pengiriman berulang: pastikan tindakan aman untuk diulang dengan task_id yang sama, agar pemanggilan lain tidak memublikasikan video yang sama atau menambahkan catatan yang sama dua kali.

Pastikan langganan tetap berjalanSalin tautan jangkar

Daemon CLI menangani peristiwa penyelesaian dan menjalankan metode pengiriman yang Anda aktifkan. Setelah memilih metode, jalankan daemon dan periksa status pengiriman:

reela daemon start
reela subscribe status

Menambahkan metode juga akan mencoba menjalankan daemon yang berhenti. Jika daemon sudah berjalan, mulai ulang setelah mengubah pengaturan pengiriman agar perubahan tersebut diterapkan. Untuk daemon yang dijalankan secara manual, gunakan reela daemon stop diikuti reela daemon start.

Reela menyimpan progres pengiriman dan melanjutkannya dari progres tersebut saat daemon dimulai ulang. Jika tidak ada progres tersimpan, secara default Reela akan mengikuti peristiwa baru. reela daemon start --keep-backlog juga memproses peristiwa tugas yang sudah selesai sebelumnya dan masih tersedia ketika tidak ada progres tersimpan.

Gunakan reela daemon install untuk mengaktifkan startup saat masuk. Jika dipasang sebagai layanan, mulai ulang melalui pengelola layanan sistem operasi Anda setelah mengubah konfigurasi. Periksa reela daemon status atau reela daemon logs --tail 50 untuk memeriksa pengiriman.

Pengiriman otomatis mengharuskan komputer yang menjalankan daemon tetap menyala dan terhubung. Jalankan daemon sebelum mengirimkan video yang penyelesaiannya harus memicu skrip Anda.

daemon dan subscribe tersedia di Linux dan macOS. Windows x64 mendukung perintah video, pemeriksaan status, dan unduhan manual.

Pengiriman unduhan dan email opsionalSalin tautan jangkar

Anda dapat mengaktifkan unduhan otomatis atau email video yang sudah selesai bersama skrip Anda. Unduhan diaktifkan dalam pengaturan pengiriman default; tentukan lokasi tujuan dengan reela config set delivery.download ~/Videos/reela. Jika dinonaktifkan, aktifkan dengan reela subscribe add download --dir ~/Videos/reela. Aktifkan email dengan reela subscribe add email, dan jika mau, tambahkan --address me@example.com untuk menggunakan alamat selain email akun Anda.

Beberapa metode dapat aktif secara bersamaan, dan kegagalan satu metode tidak mencegah metode lainnya berjalan. Setiap pemanggilan skrip menerima payload penyelesaiannya sendiri, termasuk informasi unduhan jika tersedia. Lihat referensi perintah pengiriman untuk semua metode.

Gunakan kembali penyiapan produksi AndaSalin tautan jangkar

Reela menyediakan kemampuan tambahan yang dapat menjadi langkah dalam alur kerja Anda:

• Pencitraan merek yang konsisten: tampilkan daftar paket merek yang sudah ada dengan brand list dan terapkan salah satunya ke tugas dengan brand apply. Perintah ini menunggu hingga output bermerek selesai. Lihat perintah merek.
• Pengeditan terprogram: unduh JSON edit, validasi perubahan, simpan draf untuk pratinjau, dan kirimkan render dengan edit. Lihat perintah pengeditan.
• Akun dan preferensi terpisah: pilih profil dengan --profile atau REELA_PROFILE. Metode dan pengaturan pengiriman berlaku untuk profil yang dipilih. Lihat profil dan konfigurasi.

Sebagai contoh, alur kerja video produk dapat mengirimkan brief dengan gambar referensi dan menggunakan langganan penyelesaian daemon untuk meneruskan video yang sudah selesai ke alat publikasi Anda. Reela menyediakan pembuatan di latar belakang dan pengiriman hasil setelah selesai; alat Anda menentukan kapan harus mengirimkan tugas dan tindakan apa yang dilakukan saat hasil diterima.

Lihat referensi perintah pengiriman untuk semua opsi langganan dan daemon. Untuk instalasi dan otorisasi akun, mulai dengan Memulai.