Webhooky v sekcii „Video avatary“: upozornenie na váš server, keď bude video pripravené
Webhooky v sekcii "Video avatary" je spôsob, ako zistiť, že video je pripravené, bez manuálneho obnovovania stránky: hneď po dokončení videa sa na adresu vášho servera odošle požiadavka POST a váš server sám rozhodne, čo ďalej – napíšete odkaz na databázu, odošlete súbor klientovi alebo spustíte ďalší krok. Kartu potrebujú tí, ktorí robia videá v dávkach alebo integrujú generovanie avatarov do svojho produktu: namiesto nekonečných kontrol „pripravený alebo ešte nie“ príde v ten správny moment jedno krátke upozornenie.
Prečo je to vôbec potrebné?
Vykreslenie videa nie je okamžitá operácia a nemá zmysel na ňu čakať na otvorenej karte. Podľa meraní platformy z 07.09.2026 sa päťsekundové video Kling 3.0 v rozlíšení 1080p považuje za priemernú dĺžku 115 sekúnd a v 95 % prípadov sa zmestí do 165. Pre Sora 2 tá istá úloha trvá v priemere asi 145 sekúnd. Ak kontrolujete stav každých pár sekúnd, v jednom videu sa objavia desiatky prázdnych požiadaviek; Webhook prichádza iba raz - keď sa výsledok skutočne objaví.
Za všetko hovorí aj objem. Podľa denníka generovania platformy sa za 30 dní (3. septembra – 2. októbra 2026) spustilo 3 292 video úloh, z ktorých 2 369 bolo úspešne dokončených. Videá sa počítajú na pozadí a končia v rôznych časoch – to sa nedá sledovať manuálne a úhľadný obslužný program upozornení rieši problém sám.
Čo robí karta Webhooky?
Je to všetko o doručovaní upozornení bez mágie. Zaregistrujete si adresu, vyberiete si udalosti, na ktoré sa chcete prihlásiť, a dostanete tajný kód odberu. Zoznam registrovaných koncových bodov je uložený priamo tam: môžete vidieť adresu, vybrané udalosti, stav a či má koncový bod tajomstvo. Tajomstvo môže byť znovu uvoľnené (staré okamžite prestane fungovať) alebo môže byť koncový bod úplne vymazaný.
Udalosť pochádza iba z vašich videí: video niekoho iného sa nezverejní, aj keď bolo započítané v rovnakom momente. K dispozícii je tiež denník doručených udalostí - je vhodné skontrolovať, či sa niečo skutočne dostalo na váš server.
Ako začať - krok za krokom
- Otvorená sekcia "Video avatary" a panel webhooku na priamej adrese /ru/avatars?tab=webhooks.
- Prihláste sa do svojho účtu: nastavenie nie je dostupné pre hostí; po kliknutí sa otvorí prihlasovacie okno.
- Do poľa Adresa koncového bodu zadajte verejnú adresu HTTPS vášho servera, napríklad https://example.com/avatar-webhook. HTTP nebude fungovať – doručovanie a podpisovanie sú navrhnuté pre zabezpečený kanál.
- Označte požadované udalosti. Ak nič nevyberiete, budete prihlásení na odber všetkých udalostí naraz.
- Kliknite na „Pridať koncový bod“. Ihneď po vytvorení sa objaví tajný kľúč odberu - skopírujte si ho a uložte si ho: už sa nebude zobrazovať.
- Ak ešte nemáte vlastný server, kliknite na „Nahradiť nášho prijímača“ - upozornenia sa budú hromadiť v protokole doručených udalostí priamo v záložke.
Ako sa uistiť, že žiadosť je od nás a nie falošná
Každá požiadavka je sprevádzaná hlavičkou podpisu - to je HMAC-SHA256, vypočítaná z nespracovaného tela požiadavky ako vaše tajomstvo. Na vašej strane spočítajte rovnaký podpis a porovnajte ho: ak sa nezhoduje, žiadosť zahodíme. Náš prijímač robí presne toto a odpovedá 401 na nesprávny podpis. Udržujte tajomstvo na serveri, v premenných prostredia a nie v kóde klienta.
Čo je uvedené v žiadosti
Telo je obyčajný JSON s typom udalosti a údajmi entity. Napríklad pre hotové video je to udalosť BLK0 s identifikátorom videa vo vnútri. Úplný zoznam dostupných typov udalostí je zobrazený na karte: môžete si ho triediť a nechať len to, čo vaša služba skutočne potrebuje.
koľko to stojí
Registrácia koncového bodu, tajné opätovné vydanie, vymazanie a protokol udalostí neodpisujú tokeny – ide o nastavenie upozornení, nie generovanie. Tokeny sa míňajú iba na samotné video: cena v tokenoch je viditeľná pred spustením a ak úloha zlyhá, vráti sa to, čo bolo odpísané. Neexistuje žiadne predplatné: noví používatelia dostanú štartovacie tokeny za svoje prvé testy.
S čím kombinovať
- "Dávkové úlohy" — spustenie desiatok videí s jednou úlohou; Webhook eliminuje potrebu manuálneho ovládania pripravenosti.
- "Mediálna knižnica" — ukladanie zdrojových kódov a hotových súborov.
- "Preklad videa" A "strihanie klipov" — ďalšie kroky po generácii.
Často kladené otázky
Ktorá adresa je vhodná pre webhook?
Iba verejné HTTPS. Lokálne adresy a HTTP nie sú akceptované: upozornenie musí ísť cez zabezpečený kanál a váš server musí byť prístupný zvonku.
Je možné dostávať upozornenia, ak neexistuje server?
áno. Kliknite na „Nahradiť nášho prijímača“ – udalosti sa zhromažďujú v protokole „Doručené udalosti“ na karte, je možné ich zobraziť bez vášho backendu.
Čo robiť, ak sa podpis nezhoduje?
Skontrolujte, či čítate HMAC-SHA256 z nespracovaného tela požiadavky (a nie z analyzovaného JSON) a či používate aktuálny tajný kód: po opätovnom vydaní starý okamžite prestane fungovať.
Je to platené?
Nastavenie webhookov neodpisuje tokeny. Tokeny sa míňajú iba na generovanie videa - ich cena je viditeľná pred spustením; Neexistuje žiadne predplatné, noví používatelia dostávajú štartovacie tokeny.