Webhook di bagian “Avatar video”: pemberitahuan ke server Anda ketika video sudah siap
Webhook di bagian tersebut "Avatar Video" adalah cara untuk mengetahui bahwa video sudah siap, tanpa menyegarkan halaman secara manual: segera setelah video selesai, permintaan POST dikirim ke alamat server Anda, dan server Anda sendiri yang memutuskan apa yang harus dilakukan selanjutnya - tulis tautan ke database, kirim file ke klien, atau mulai langkah berikutnya. Tab ini dibutuhkan oleh mereka yang membuat video secara berkelompok atau mengintegrasikan pembuatan avatar ke dalam produk mereka: alih-alih pemeriksaan “siap atau belum” yang tiada henti, satu pemberitahuan singkat datang pada saat yang tepat.
Mengapa ini perlu?
Merender video bukanlah operasi instan, dan tidak ada gunanya menunggu di tab yang terbuka. Menurut pengukuran platform tertanggal 09/07/2026, video Kling 3.0 berdurasi lima detik dalam 1080p dianggap rata-rata berdurasi 115 detik, dan dalam 95% kasus, video tersebut masuk ke dalam 165 detik. Untuk Sora 2, tugas yang sama memakan waktu rata-rata sekitar 145 detik. Jika Anda memeriksa status setiap beberapa detik, lusinan permintaan kosong muncul dalam satu video; Webhook hanya muncul sekali - saat hasilnya benar-benar muncul.
Volumenya juga berbicara sendiri. Menurut log generasi platform, selama 30 hari (3 September – 2 Oktober 2026), 3.292 tugas video dimulai, dan 2.369 di antaranya berhasil diselesaikan. Video dihitung di latar belakang dan berakhir pada waktu yang berbeda - ini tidak dapat dilacak secara manual, dan penangan notifikasi yang rapi menyelesaikan masalahnya sendiri.
Apa fungsi tab “Webhook”?
Ini semua tentang menyampaikan notifikasi, tanpa keajaiban. Anda mendaftarkan alamat, memilih acara mana yang ingin Anda ikuti, dan menerima rahasia berlangganan. Daftar titik akhir yang terdaftar disimpan di sana: Anda dapat melihat alamat, acara yang dipilih, status, dan apakah titik akhir memiliki rahasia. Rahasianya dapat dirilis ulang (yang lama akan segera berhenti berfungsi) atau titik akhir dapat dihapus seluruhnya.
Peristiwa hanya berasal dari video Anda: video orang lain tidak akan keluar, meskipun dihitung pada saat yang sama. Ada juga log peristiwa yang dikirimkan - akan lebih mudah untuk memeriksa apakah sesuatu benar-benar mencapai server Anda.
Bagaimana memulainya - langkah demi langkah
- Bagian terbuka "Avatar Video" dan panel webhook di alamat langsung /ru/avatar?tab=webhook.
- Masuk ke akun Anda: pengaturan tidak tersedia untuk tamu; ketika diklik, jendela login akan terbuka.
- Di bidang “Alamat Titik Akhir”, masukkan alamat HTTPS publik server Anda, misalnya https://example.com/avatar-webhook. HTTP tidak akan berfungsi - pengiriman dan penandatanganan dirancang untuk saluran aman.
- Tandai acara yang diperlukan. Jika Anda tidak memilih apa pun, Anda akan berlangganan semua acara sekaligus.
- Klik "Tambahkan titik akhir". Segera setelah pembuatan, rahasia berlangganan akan muncul - salin dan simpan untuk Anda sendiri: rahasia itu tidak akan ditampilkan lagi.
- Jika Anda belum memiliki server sendiri, klik "Ganti penerima kami" - maka notifikasi akan diakumulasikan di log acara yang dikirimkan langsung di tab.
Bagaimana memastikan bahwa permintaan tersebut berasal dari kami dan bukan palsu
Setiap permintaan disertai dengan header tanda tangan - ini adalah HMAC-SHA256, dihitung dari isi mentah permintaan sebagai rahasia Anda. Di pihak Anda, hitung tanda tangan yang sama dan bandingkan: jika tidak cocok, kami membuang permintaan tersebut. Penerima kami melakukan hal ini dan merespons dengan 401 untuk tanda tangan yang salah. Jaga rahasia di server, di variabel lingkungan, dan bukan di kode klien.
Apa yang ada dalam permintaan tersebut
Isinya adalah JSON biasa dengan jenis peristiwa dan data entitas. Misalnya, untuk video yang sudah selesai, ini adalah acara BLK0 dengan pengenal video di dalamnya. Daftar lengkap jenis acara yang tersedia ditampilkan di tab: Anda dapat memilahnya dan hanya menyisakan apa yang benar-benar dibutuhkan layanan Anda.
harganya berapa
Pendaftaran titik akhir, rilis ulang rahasia, penghapusan, dan log peristiwa tidak menghapus token - ini adalah pengaturan notifikasi, bukan pembuatan. Token hanya digunakan untuk video itu sendiri: harga dalam token terlihat sebelum peluncuran, dan jika tugas gagal, apa yang telah dihapuskan akan dikembalikan. Tidak ada langganan: pengguna baru diberikan token awal untuk pengujian pertama mereka.
Dengan apa harus digabungkan
- "Tugas kumpulan" — meluncurkan lusinan video dengan satu tugas; Webhook akan menghilangkan kebutuhan akan kontrol kesiapan manual.
- "Perpustakaan media" — penyimpanan kode sumber dan file jadi.
- "Terjemahan video" Dan "Pemotongan klip" — langkah selanjutnya dari generasi ke generasi.
Pertanyaan yang sering diajukan
Alamat mana yang cocok untuk webhook?
Hanya HTTPS publik. Alamat lokal dan HTTP tidak diterima: notifikasi harus melalui saluran aman, dan server Anda harus dapat diakses dari luar.
Apakah mungkin menerima notifikasi jika tidak ada server?
Ya. Klik "Gantikan penerima kami" - acara akan diakumulasikan di log "Acara terkirim" di tab, acara tersebut dapat dilihat tanpa backend Anda.
Apa yang harus dilakukan jika tanda tangannya tidak cocok?
Periksa apakah Anda membaca HMAC-SHA256 dari isi permintaan mentah (dan bukan dari JSON yang diurai) dan apakah Anda menggunakan rahasia saat ini: setelah diterbitkan ulang, rahasia lama segera berhenti berfungsi.
Apakah ini berbayar?
Menyiapkan webhook tidak menghapus token. Token hanya dibelanjakan untuk pembuatan video - harganya terlihat sebelum peluncuran; Tidak ada langganan, pengguna baru diberikan token awal.