Webhooky v sekci „Video avatary“: upozornění na váš server, když je video připraveno

Webhooky v sekci "Video Avatary" je způsob, jak zjistit, že je video připraveno, bez ručního obnovování stránky: jakmile je video dokončeno, odešle se požadavek POST na adresu vašeho serveru a váš server sám rozhodne, co dál – zapsat odkaz na databázi, odeslat soubor klientovi nebo zahájit další krok. Kartu potřebují ti, kteří dělají videa v dávkách nebo integrují generování avatarů do svého produktu: namísto nekonečných kontrol „připraveno nebo ještě ne“ přichází jedno krátké upozornění přesně ve správný okamžik.

Proč je to vůbec nutné?

Vykreslení videa není okamžitá operace a nemá smysl na něj čekat na otevřené kartě. Podle měření platformy ze dne 09.07.2026 je pětisekundové video Kling 3.0 v rozlišení 1080p považováno za průměr 115 sekund a v 95 % případů se vejde do 165. U Sora 2 trvá stejná úloha v průměru asi 145 sekund. Pokud stav kontrolujete každých pár sekund, v jednom videu se objeví desítky prázdných požadavků; Webhook přichází pouze jednou - když se výsledek skutečně objeví.

Hlasitost také mluví sama za sebe. Podle protokolu generování platformy se za 30 dní (3. září – 2. října 2026) spustilo 3 292 video úloh, z nichž 2 369 bylo úspěšně dokončeno. Videa se počítají na pozadí a končí v různých časech – to nelze sledovat ručně a úhledný obslužný program upozornění řeší problém sám.

Co dělá karta Webhooky?

Je to všechno o doručování oznámení, bez magie. Zaregistrujete si adresu, vyberete si, které události odebíráte, a obdržíte tajný klíč předplatného. Seznam registrovaných koncových bodů je uložen přímo tam: můžete vidět adresu, vybrané události, stav a zda má koncový bod tajemství. Tajný klíč lze znovu uvolnit (starý okamžitě přestane fungovat) nebo lze koncový bod zcela odstranit.

Událost pochází pouze z vašich videí: video někoho jiného se nezveřejní, i když bylo započítáno ve stejnou chvíli. K dispozici je také protokol doručených událostí - je vhodné zkontrolovat, zda se něco skutečně dostalo na váš server.

Jak začít – krok za krokem

1. Otevřená sekce "Video Avatary" a webhookový panel na přímé adrese /ru/avatars?tab=webhooks.
2. Přihlaste se ke svému účtu: nastavení není dostupné pro hosty; po kliknutí se otevře přihlašovací okno.
3. Do pole „Adresa koncového bodu“ zadejte veřejnou HTTPS adresu vašeho serveru, například https://example.com/avatar-webhook. HTTP nebude fungovat – doručování a podepisování jsou navrženy pro zabezpečený kanál.
4. Označte požadované události. Pokud nic nevyberete, budete přihlášeni k odběru všech událostí najednou.
5. Klikněte na "Přidat koncový bod". Ihned po vytvoření se objeví tajný klíč předplatného - zkopírujte si jej a uložte si ho: již se nebude zobrazovat.
6. Pokud ještě nemáte vlastní server, klikněte na „Nahradit našeho přijímače“ – upozornění se budou hromadit v protokolu doručených událostí přímo v záložce.

Jak se ujistit, že žádost je od nás a není falešná

Každý požadavek je doprovázen hlavičkou podpisu – to je HMAC-SHA256, vypočítaný z nezpracovaného těla požadavku jako vaše tajemství. Na vaší straně spočítejte stejný podpis a porovnejte: pokud se neshoduje, žádost zahodíme. Náš přijímač dělá přesně toto a odpoví 401 na nesprávný podpis. Udržujte tajemství na serveru, v proměnných prostředí a ne v kódu klienta.

Co je uvedeno v žádosti

Tělo je prostý JSON s typem události a daty entity. Například pro hotové video je to událost BLK0 s identifikátorem videa uvnitř. Úplný seznam dostupných typů událostí je zobrazen na kartě: můžete je třídit a ponechat pouze to, co vaše služba skutečně potřebuje.

kolik to stojí

Registrace koncového bodu, tajné opětovné vydání, mazání a protokol událostí neodepisují tokeny – toto je nastavení upozornění, nikoli generování. Tokeny se utrácejí pouze za samotné video: cena v tokenech je viditelná před spuštěním, a pokud úkol selže, vrátí se odepsané. Neexistuje žádné předplatné: noví uživatelé dostávají startovní žetony za své první testy.

S čím kombinovat

• "Dávkové úkoly" — spuštění desítek videí s jedním úkolem; Webhook eliminuje potřebu ručního ovládání připravenosti.
• "Knihovna médií" — ukládání zdrojových kódů a hotových souborů.
• "Video překlad" A "Řezání klipů" — další kroky po generaci.

Často kladené otázky

Která adresa je vhodná pro webhook?

Pouze veřejné HTTPS. Místní adresy a HTTP nejsou akceptovány: oznámení musí projít zabezpečeným kanálem a váš server musí být přístupný zvenčí.

Je možné dostávat upozornění, pokud neexistuje server?

Ano. Klikněte na „Nahradit našeho přijímače“ – události se budou shromažďovat v protokolu „Doručené události“ na kartě, lze je zobrazit bez vašeho backendu.

Co dělat, když podpis nesouhlasí?

Zkontrolujte, že čtete HMAC-SHA256 z nezpracovaného těla požadavku (a ne z analyzovaného JSON) a že používáte aktuální tajný klíč: po opětovném vydání starý okamžitě přestane fungovat.

Je to placené?

Nastavení webhooků neodepisuje tokeny. Tokeny se utrácejí pouze za generování videa – jejich cena je viditelná před spuštěním; Neexistuje žádné předplatné, noví uživatelé získávají startovní tokeny.