Webhooks în secțiunea „Avatare video”: notificare către server când videoclipul este gata
Webhook-uri în secțiune „Avatare video” este o modalitate de a afla că videoclipul este gata, fără a reîmprospăta manual pagina: de îndată ce videoclipul a fost finalizat, o solicitare POST este trimisă la adresa serverului dvs., iar serverul dvs. însuși decide ce să facă în continuare - scrieți linkul către baza de date, trimiteți fișierul către client sau începeți pasul următor. Fila este nevoie de cei care realizează videoclipuri în loturi sau integrează generarea de avatare în produsul lor: în loc de verificări nesfârșite „gata sau nu”, o scurtă notificare ajunge exact în momentul potrivit.
De ce este chiar necesar acest lucru?
Redarea unui videoclip nu este o operațiune instantanee și nu are rost să-l așteptați într-o filă deschisă. Conform măsurătorilor platformei din 09/07/2026, un videoclip Kling 3.0 de cinci secunde în 1080p este considerat o medie de 115 secunde, iar în 95% din cazuri se încadrează în 165. Pentru Sora 2, aceeași sarcină durează în medie aproximativ 145 de secunde. Dacă verificați starea la fiecare câteva secunde, într-un videoclip apar zeci de solicitări goale; Webhook-ul vine o singură dată - când rezultatul apare de fapt.
Volumul vorbește și de la sine. Conform jurnalului de generare al platformei, în decurs de 30 de zile (3 septembrie – 2 octombrie 2026), au început 3.292 de activități video, dintre care 2.369 s-au finalizat cu succes. Videoclipurile sunt numărate în fundal și se termină în momente diferite - acest lucru nu poate fi urmărit manual, iar un gestionator de notificări ordonat rezolvă problema în sine.
Ce face fila „Webhooks”?
Totul este despre livrarea notificărilor, fără magie. Înregistrați o adresă, alegeți la ce evenimente să vă abonați și primiți un secret de abonament. Lista punctelor finale înregistrate este stocată chiar acolo: puteți vedea adresa, evenimentele selectate, starea și dacă punctul final are un secret. Secretul poate fi relansat (cel vechi va înceta imediat să funcționeze) sau punctul final poate fi șters în întregime.
Evenimentul vine doar din videoclipurile tale: videoclipul altcuiva nu va iesi, chiar daca a fost contorizat in acelasi moment. Există, de asemenea, un jurnal al evenimentelor livrate - este convenabil să verificați dacă ceva a ajuns efectiv la serverul dvs.
Cum să începeți - pas cu pas
- Deschideți secțiunea „Avatare video” și panoul webhook la adresa directă /ru/avatars?tab=webhooks.
- Conectați-vă la contul dvs.: setarea nu este disponibilă pentru oaspeți; când faceți clic, se va deschide o fereastră de conectare.
- În câmpul „Endpoint Address”, introduceți adresa HTTPS publică a serverului dvs., de exemplu https://example.com/avatar-webhook. HTTP nu va funcționa - livrarea și semnarea sunt concepute pentru un canal securizat.
- Marcați evenimentele necesare. Dacă nu selectați nimic, veți fi abonat la toate evenimentele simultan.
- Faceți clic pe „Adăugați punctul final”. Imediat după creare, va apărea secretul abonamentului - copiați și salvați-l pentru dvs.: nu va fi afișat din nou.
- Dacă nu aveți încă propriul server, faceți clic pe „Înlocuiește-ne receptorul” - atunci notificările vor fi acumulate în jurnalul evenimentelor livrate direct în filă.
Cum să ne asigurăm că cererea este de la noi și nu este un fals
Fiecare cerere este însoțită de un antet de semnătură - acesta este HMAC-SHA256, calculat din corpul brut al cererii ca secret. De partea dvs., numărați aceeași semnătură și comparați: dacă nu se potrivește, renunțăm la cerere. Receptorul nostru face exact acest lucru și răspunde cu 401 la o semnătură incorectă. Păstrați secretul pe server, în variabilele de mediu și nu în codul clientului.
Ce vine în cerere
Corpul este simplu JSON cu tipul evenimentului și datele entității. De exemplu, pentru un videoclip finalizat, acesta este evenimentul BLK0 cu identificatorul video în interior. Lista completă a tipurilor de evenimente disponibile este afișată în filă: puteți sorta și lăsa doar ceea ce are nevoie serviciul dvs.
Cât costã
Înregistrarea punctului final, relansarea secretă, ștergerea și jurnalul de evenimente nu anulează jetoanele - aceasta este setarea de notificare, nu generare. Token-urile sunt cheltuite doar pe videoclipul în sine: prețul în jetoane este vizibil înainte de lansare, iar dacă sarcina eșuează, ceea ce a fost anulat este returnat. Nu există abonament: utilizatorii noi primesc jetoane de pornire pentru primele lor teste.
Cu ce să combinați
- „Sarcini pe lot” — lansarea a zeci de videoclipuri cu o singură sarcină; Un webhook va elimina necesitatea controlului manual al pregătirii.
- „Biblioteca media” — stocarea codurilor sursă și a fișierelor terminate.
- „Traducere video” Şi "Tăierea clipurilor" — următorii pași după generație.
Întrebări frecvente
Ce adresă este potrivită pentru un webhook?
Numai HTTPS public. Adresele locale și HTTP nu sunt acceptate: notificarea trebuie să treacă pe un canal securizat, iar serverul dvs. trebuie să fie accesibil din exterior.
Este posibil să primiți notificări dacă nu există server?
Da. Faceți clic pe „Înlocuiește-ne receptorul” - evenimentele vor fi acumulate în jurnalul „Evenimente livrate” din filă, ele pot fi vizualizate fără backend-ul tău.
Ce să faci dacă semnătura nu se potrivește?
Verificați dacă citiți HMAC-SHA256 din corpul cererii brute (și nu din JSON analizat) și că utilizați secretul actual: după reemitere, cel vechi încetează imediat să funcționeze.
Acesta este plătit?
Configurarea webhook-urilor nu anulează jetoanele. Tokenurile sunt cheltuite doar pentru generarea video - prețul lor este vizibil înainte de lansare; Nu există abonament, utilizatorii noi li se acordă jetoane de pornire.