← Все статьи

Webhooks dalam bahagian "Avatar video": pemberitahuan kepada pelayan anda apabila video sudah sedia

Adegan terang: video yang telah siap dipaparkan pada skrin dengan butang main, garis isyarat bercahaya pergi daripadanya ke pelayan yang kemas, loceng pemberitahuan berkelip di atas pelayan

Webhooks dalam bahagian "Avatar Video" ialah satu cara untuk mengetahui bahawa video itu sudah sedia, tanpa memuat semula halaman secara manual: sebaik sahaja video selesai, permintaan POST dihantar ke alamat pelayan anda, dan pelayan anda sendiri memutuskan perkara yang perlu dilakukan seterusnya - tulis pautan ke pangkalan data, hantar fail kepada klien, atau mulakan langkah seterusnya. Tab ini diperlukan oleh mereka yang membuat video dalam kelompok atau menyepadukan penjanaan avatar ke dalam produk mereka: bukannya semakan "sedia atau belum" yang tidak berkesudahan, satu pemberitahuan ringkas tiba tepat pada masa yang tepat.

Mengapa ini perlu?

Memaparkan video bukanlah operasi segera, dan tidak ada gunanya menunggunya dalam tab terbuka. Menurut ukuran platform bertarikh 09/07/2026, video Kling 3.0 lima saat dalam 1080p dianggap sebagai purata 115 saat, dan dalam 95% kes ia sesuai dengan 165. Untuk Sora 2, tugasan yang sama mengambil masa purata kira-kira 145 saat. Jika anda menyemak status setiap beberapa saat, berpuluh-puluh permintaan kosong muncul dalam satu video; Webhook datang sekali sahaja - apabila hasilnya benar-benar muncul.

Kelantangan juga bercakap untuk dirinya sendiri. Menurut log penjanaan platform, sepanjang 30 hari (3 September – 2 Oktober 2026), 3,292 tugasan video bermula, yang mana 2,369 berjaya diselesaikan. Video dikira di latar belakang dan tamat pada masa yang berbeza - ini tidak boleh dikesan secara manual dan pengendali pemberitahuan yang kemas menyelesaikan masalah itu sendiri.

Apakah yang dilakukan oleh tab "Webhooks"?

Ini semua tentang menyampaikan pemberitahuan, tanpa sihir. Anda mendaftarkan alamat, memilih acara untuk dilanggan dan menerima rahsia langganan. Senarai titik tamat berdaftar disimpan di sana: anda boleh melihat alamat, acara terpilih, status dan sama ada titik tamat mempunyai rahsia. Rahsia itu boleh dikeluarkan semula (yang lama akan segera berhenti berfungsi) atau titik akhir boleh dipadamkan sepenuhnya.

Acara itu datang hanya daripada video anda: video orang lain tidak akan keluar, walaupun ia dikira pada masa yang sama. Terdapat juga log acara yang dihantar - mudah untuk menyemak sama ada sesuatu telah sampai ke pelayan anda.

Bahagian

Bagaimana untuk bermula - langkah demi langkah

  1. Buka bahagian "Avatar Video" dan panel webhook di alamat langsung /ru/avatars?tab=webhooks.
  2. Log masuk ke akaun anda: tetapan tidak tersedia untuk tetamu; apabila diklik, tetingkap log masuk akan dibuka.
  3. Dalam medan "Alamat Titik Akhir", masukkan alamat HTTPS awam pelayan anda, contohnya https://example.com/avatar-webhook. HTTP tidak akan berfungsi - penghantaran dan tandatangan direka untuk saluran selamat.
  4. Tandakan acara yang diperlukan. Jika anda tidak memilih apa-apa, anda akan melanggan semua acara sekaligus.
  5. Klik "Tambah titik akhir". Sejurus selepas penciptaan, rahsia langganan akan muncul - salin dan simpan untuk diri sendiri: ia tidak akan dipaparkan lagi.
  6. Jika anda belum mempunyai pelayan anda sendiri, klik "Ganti penerima kami" - kemudian pemberitahuan akan terkumpul dalam log peristiwa yang dihantar terus dalam tab.

Bagaimana untuk memastikan bahawa permintaan adalah daripada kami dan bukan palsu

Setiap permintaan disertakan dengan pengepala tandatangan - ini ialah HMAC-SHA256, dikira daripada kandungan mentah permintaan sebagai rahsia anda. Di pihak anda, kira tandatangan yang sama dan bandingkan: jika ia tidak sepadan, kami membuang permintaan itu. Penerima kami melakukan perkara ini dengan tepat dan membalas dengan 401 kepada tandatangan yang salah. Simpan rahsia pada pelayan, dalam pembolehubah persekitaran, dan bukan dalam kod klien.

Apa yang terdapat dalam permintaan itu

Isinya ialah JSON biasa dengan jenis acara dan data entiti. Contohnya, untuk video siap, ini ialah acara BLK0 dengan pengecam video di dalamnya. Senarai penuh jenis acara yang tersedia ditunjukkan dalam tab: anda boleh mengisihnya dan meninggalkan hanya perkara yang benar-benar diperlukan oleh perkhidmatan anda.

Berapa kosnya

Pendaftaran titik akhir, pelepasan semula rahsia, pemadaman dan log peristiwa tidak menghapuskan token - ini adalah tetapan pemberitahuan, bukan penjanaan. Token hanya dibelanjakan untuk video itu sendiri: harga dalam token kelihatan sebelum pelancaran, dan jika tugas itu gagal, apa yang telah dihapus kira akan dikembalikan. Tiada langganan: pengguna baharu diberikan token permulaan untuk ujian pertama mereka.

Apa yang perlu digabungkan

Soalan lazim

Alamat manakah yang sesuai untuk webhook?

HTTPS awam sahaja. Alamat tempatan dan HTTP tidak diterima: pemberitahuan mesti melalui saluran selamat dan pelayan anda mesti boleh diakses dari luar.

Adakah mungkin untuk menerima pemberitahuan jika tiada pelayan?

ya. Klik "Ganti penerima kami" - acara akan terkumpul dalam log "Acara dihantar" dalam tab, ia boleh dilihat tanpa bahagian belakang anda.

Apa yang perlu dilakukan jika tandatangan tidak sepadan?

Semak sama ada anda membaca HMAC-SHA256 dari badan permintaan mentah (dan bukan dari JSON yang dihuraikan) dan bahawa anda menggunakan rahsia semasa: selepas mengeluarkan semula, yang lama berhenti berfungsi dengan serta-merta.

Adakah ini dibayar?

Menyediakan webhooks tidak menghapuskan token. Token dibelanjakan hanya untuk penjanaan video - harganya boleh dilihat sebelum pelancaran; Tiada langganan, pengguna baharu diberikan token permulaan.