Kode widget video: cara tugas latar belakang sampai ke pengunjung
Pembuatan video butuh hitungan menit, bukan detik. Panduan ini menjelaskan apa yang terjadi di balik kode widget video, dari permintaan pertama hingga klip jadi, dan apa yang dilihat pengunjung.
Diterbitkan:
Jawaban chat mengalir dalam hitungan detik. Video yang dibuat AI bisa butuh beberapa menit. Widget video dirancang dengan memperhitungkan perbedaan itu, sehingga pengunjung Anda mendapat pengalaman yang jelas dan akun Anda tetap terlindungi selama tugas berjalan.
Satu baris kode yang sama
Setiap jenis widget memakai kode sematan yang sama:
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Perbedaannya ada di server. Saat jenis widget adalah Video, prompt pengunjung memulai sebuah tugas alih-alih langsung mengembalikan hasil.
Langkah demi langkah
- Pengunjung mengirim prompt. Permintaan dikirim ke api14 dengan id widget Anda. Server memeriksa bahwa halaman berada di salah satu situs yang Anda izinkan, menerapkan batas Anda, dan memulai tugas dengan model pilihan Anda.
- Id tugas dikembalikan. Widget menampilkan status sedang bekerja. Id tugas terikat pada widget Anda: widget lain, atau siapa pun yang menebak id, tidak bisa membacanya.
- Widget memeriksa status. Setiap beberapa detik, widget menanyakan apakah video sudah siap. Pemeriksaan ini dibatasi lajunya secara terpisah dari prompt baru, sehingga tugas yang lama tidak menghabiskan kuota permintaan pengunjung.
- Video diputar. Saat tugas selesai, widget mengunduh klipnya, memutarnya, dan menampilkan tautan Unduh.
Jika pembuatan gagal, pengunjung melihat pesan galat Anda (atau pesan bawaan yang netral), dan alasannya muncul di daftar widget Anda agar bisa Anda perbaiki.
Yang Anda kendalikan
- Model: dipilih di Widget. Widget meminta durasi yang didukung paling dekat dengan 5 detik dan resolusi paling dekat dengan 720p, sehingga biaya per klip tetap terprediksi.
- API key: setiap widget berjalan dengan salah satu API key Anda, yang dipilih di editor. Daftarnya diakhiri dengan Buat API key baru. Tugas dicatat di bawah key tersebut dan batasnya berlaku.
- Tampilan: judul, teks, warna aksen, tema, kelengkungan sudut, dan penempatan. Widget ini white label.
Pengunjung tidak pernah melihat bagian dalamnya
Pengunjung hanya melihat teks Anda, status proses, dan video yang sudah jadi. Instruksi Anda, saldo Anda, API key Anda, dan galat mentah dari penyedia semuanya tetap di server.
Pemantauan
Daftar widget menampilkan pemakaian terakhir, pengeluaran hari ini, dan galat terakhir untuk setiap widget. Pemakaian mengelompokkan permintaan per widget atau per situs, dan email kegagalan memberi tahu Anda tentang masalah yang bisa Anda perbaiki, seperti saldo kosong atau model yang sudah dihapus.
Pelajari lebih lanjut tentang model video di dokumentasi video dan buat widget Anda di halaman widget.