Webhookok a „Videó avatarok” részben: értesítés a szervernek, ha a videó készen áll

Webhookok a részben "Videó avatarok" egy módja annak, hogy megtudja, hogy a videó készen áll az oldal manuális frissítése nélkül: amint a videó elkészült, a rendszer egy POST kérést küld a szerver címére, és a szerver maga dönti el, hogy mit tegyen – írja be a hivatkozást az adatbázisba, küldje el a fájlt a kliensnek, vagy kezdje el a következő lépést. A fülre azoknak van szükségük, akik kötegben készítenek videókat, vagy az avatarok generálását építik be termékükbe: a végtelen „kész vagy még nem” ellenőrzések helyett egy rövid értesítés pontosan a megfelelő pillanatban érkezik.

Miért van erre egyáltalán szükség?

A videó megjelenítése nem egy azonnali művelet, és nincs értelme nyitott lapon várni rá. A 2026.07.09-én kelt platformmérések szerint egy öt másodperces Kling 3.0 videó 1080p-ben átlagosan 115 másodpercnek számít, és az esetek 95%-ában belefér 165-be. A Sora 2 esetében ugyanez a feladat átlagosan körülbelül 145 másodpercet vesz igénybe. Ha néhány másodpercenként ellenőrzi az állapotot, több tucat üres kérés jelenik meg egy videóban; A webhook csak egyszer érkezik – amikor az eredmény valóban megjelenik.

A kötet is önmagáért beszél. A platform generációs naplója szerint 30 nap alatt (2026. szeptember 3. és október 2. között) 3292 videófeladat indult, ebből 2369 sikeresen befejeződött. A videókat a háttérben számolja, és különböző időpontokban ér véget – ezt nem lehet manuálisan követni, és egy ügyes értesítéskezelő maga oldja meg a problémát.

Mit csinál a „Webhooks” lap?

Minden az értesítésekről szól, varázslat nélkül. Regisztrálsz egy címet, kiválasztod, mely eseményekre szeretnél feliratkozni, és megkapod az előfizetési titkot. A regisztrált végpontok listája ott van eltárolva: láthatja a címet, a kiválasztott eseményeket, az állapotot és azt, hogy a végpontnak van-e titka. A titok újra kiadható (a régi azonnal leáll), vagy a végpont teljesen törölhető.

Az esemény csak a te videóidból származik: valaki más videója nem megy ki, még akkor sem, ha ugyanabban a pillanatban számolták. Van egy napló is a kézbesített eseményekről – kényelmes ellenőrizni, hogy valami valóban elérte-e a szervert.

Hogyan kezdje el - lépésről lépésre

1. Nyissa meg a szakaszt "Videó avatarok" és webhook panel közvetlen címen /ru/avatars?tab=webhooks.
2. Jelentkezzen be fiókjába: a beállítás nem elérhető a vendégek számára; rákattintásra egy bejelentkezési ablak nyílik meg.
3. A „Végpont címe” mezőbe írja be a szerver nyilvános HTTPS-címét, például https://example.com/avatar-webhook. A HTTP nem fog működni – a kézbesítés és az aláírás biztonságos csatornához készült.
4. Jelölje be a szükséges eseményeket. Ha nem választ ki semmit, akkor az összes eseményre egyszerre feliratkozik.
5. Kattintson a "Végpont hozzáadása" gombra. Közvetlenül a létrehozás után megjelenik az előfizetési titok - másolja ki és mentse el magának: nem jelenik meg újra.
6. Ha még nincs saját szervere, kattintson a „Vevőnket helyettesítse” gombra – ekkor az értesítések a kézbesített események naplójában, közvetlenül a fülön gyűlnek össze.

Hogyan győződjön meg arról, hogy a kérés tőlünk származik, és nem hamis

Minden kérelemhez aláírási fejléc tartozik – ez a HMAC-SHA256, amely a kérelem nyers törzséből, mint az Ön titkából kerül kiszámításra. Az Ön oldalán számolja meg ugyanazt az aláírást, és hasonlítsa össze: ha nem egyezik, elvetjük a kérést. Vevőnk pontosan ezt teszi, és 401-gyel válaszol a hibás aláírásra. Tartsa a titkot a szerveren, a környezeti változókban, és ne az ügyfélkódban.

Ami a kérésben szerepel

A törzs egyszerű JSON az eseménytípussal és az entitásadatokkal. Például egy kész videónál ez a BLK0 esemény, benne a videó azonosítóval. Az elérhető eseménytípusok teljes listája a lapon látható: válogathat, és csak azt hagyhatja meg, amire szolgáltatásának valóban szüksége van.

Mennyibe kerül

A végpont regisztráció, a titkos újrakiadás, a törlés és az eseménynapló nem írja le a tokeneket – ez értesítési beállítás, nem generálás. A tokeneket csak magára a videóra költik: az indulás előtt látható a tokenekben kifejezett ár, és ha a feladat nem sikerül, a leírtakat visszaadják. Nincs előfizetés: az új felhasználók kezdő tokeneket kapnak az első tesztekhez.

Mivel kombinálható

• "Kötegelt feladatok" — több tucat videó indítása egy feladattal; A webhook megszünteti a kézi készenléti vezérlés szükségességét.
• "Médiatár" — forráskódok és kész fájlok tárolása.
• "Videó fordítás" És "Klip vágás" — következő lépések generáció után.

Gyakran ismételt kérdések

Melyik cím alkalmas webhook számára?

Csak nyilvános HTTPS. A helyi címeket és a HTTP-t nem fogadjuk el: az értesítésnek biztonságos csatornán kell haladnia, és a szerverének kívülről elérhetőnek kell lennie.

Kapható-e értesítés, ha nincs szerver?

Igen. Kattintson a „Vevőnk helyettesítése” gombra - az események a fülön található „Kézbesített események” naplóban felhalmozódnak, és a háttérprogram nélkül is megtekinthetők.

Mi a teendő, ha az aláírás nem egyezik?

Ellenőrizze, hogy a HMAC-SHA256-ot a nyers kéréstörzsből olvassa (és nem az elemzett JSON-ból), és hogy az aktuális titkot használja: az újbóli kiadás után a régi azonnal leáll.

Ez fizetős?

A webhookok beállítása nem írja le a tokeneket. A tokeneket csak videó generálására költik – ára az indulás előtt látható; Nincs előfizetés, az új felhasználók kezdő tokeneket kapnak.