Webhooks in de sectie “Video-avatars”: melding aan uw server wanneer de video klaar is

Webhooks in de sectie "Video-avatars" is een manier om erachter te komen dat de video gereed is, zonder de pagina handmatig te vernieuwen: zodra de video is voltooid, wordt een POST-verzoek verzonden naar het adres van uw server en beslist uw server zelf wat er vervolgens moet gebeuren: schrijf de link naar de database, stuur het bestand naar de client of start de volgende stap. Het tabblad is nodig voor degenen die video's in batches maken of het genereren van avatars in hun product integreren: in plaats van eindeloze 'klaar of nog niet'-controles, komt één korte melding precies op het juiste moment.

Waarom is dit überhaupt nodig?

Het renderen van een video is geen directe handeling, en het heeft geen zin om erop te wachten in een geopend tabblad. Volgens platformmetingen van 07-09-2026 wordt een Kling 3.0-video van vijf seconden in 1080p beschouwd als gemiddeld 115 seconden, en in 95% van de gevallen past deze in 165. Voor Sora 2 duurt dezelfde taak gemiddeld ongeveer 145 seconden. Als je elke paar seconden de status controleert, verschijnen er tientallen lege verzoeken in één video; De webhook komt slechts één keer voor: wanneer het resultaat daadwerkelijk verschijnt.

Het volume spreekt ook voor zich. Volgens het generatielogboek van het platform zijn er gedurende 30 dagen (3 september – 2 oktober 2026) 3.292 videotaken gestart, waarvan 2.369 met succes voltooid. De video's worden op de achtergrond geteld en eindigen op verschillende tijdstippen - dit kan niet handmatig worden gevolgd, en een handige notificatie-handler lost het probleem zelf op.

Wat doet het tabblad ‘Webhooks’?

Het draait allemaal om het leveren van meldingen, zonder magie. U registreert een adres, kiest op welke evenementen u zich abonneert en ontvangt een abonnementsgeheim. De lijst met geregistreerde eindpunten wordt daar opgeslagen: u kunt het adres, de geselecteerde gebeurtenissen, de status zien en of het eindpunt een geheim heeft. Het geheim kan opnieuw worden vrijgegeven (het oude werkt onmiddellijk niet meer) of het eindpunt kan volledig worden verwijderd.

De gebeurtenis komt alleen uit jouw video's: de video van iemand anders wordt niet gepubliceerd, ook al werd deze op hetzelfde moment geteld. Er is ook een logboek van afgeleverde gebeurtenissen. Het is handig om te controleren of iets uw server daadwerkelijk heeft bereikt.

Hoe u aan de slag kunt gaan - stap voor stap

1. Open gedeelte "Video-avatars" en webhookpaneel op direct adres /ru/avatars?tab=webhooks.
2. Log in op uw account: de instelling is niet beschikbaar voor gasten; Wanneer erop wordt geklikt, wordt een inlogvenster geopend.
3. Voer in het veld “Endpoint Address” het openbare HTTPS-adres van uw server in, bijvoorbeeld https://example.com/avatar-webhook. HTTP werkt niet - levering en ondertekening zijn ontworpen voor een beveiligd kanaal.
4. Markeer de gewenste gebeurtenissen. Als u niets selecteert, wordt u in één keer op alle evenementen geabonneerd.
5. Klik op 'Eindpunt toevoegen'. Onmiddellijk na het aanmaken verschijnt het abonnementsgeheim - kopieer het en bewaar het voor uzelf: het wordt niet opnieuw weergegeven.
6. Als u nog geen eigen server heeft, klikt u op "Onze ontvanger vervangen" - vervolgens worden de meldingen direct op het tabblad verzameld in het logboek van afgeleverde gebeurtenissen.

Hoe u er zeker van kunt zijn dat het verzoek van ons afkomstig is en niet nep is

Elk verzoek gaat vergezeld van een handtekeningheader - dit is HMAC-SHA256, berekend op basis van de onbewerkte hoofdtekst van het verzoek als uw geheim. Tel aan uw kant dezelfde handtekening en vergelijk: als deze niet overeenkomt, negeren we het verzoek. Onze ontvanger doet precies dit en reageert met 401 op een foutieve handtekening. Bewaar het geheim op de server, in omgevingsvariabelen, en niet in de clientcode.

Wat er in het verzoek staat

De body is gewoon JSON met het gebeurtenistype en de entiteitsgegevens. Voor een voltooide video is dit bijvoorbeeld de BLK0-gebeurtenis met de video-ID erin. De volledige lijst met beschikbare gebeurtenistypen wordt op het tabblad weergegeven: u kunt er doorheen bladeren en alleen datgene achterlaten wat uw dienst echt nodig heeft.

Hoeveel kost het?

Eindpuntregistratie, geheime heruitgave, verwijdering en gebeurtenislogboek schrijven geen tokens af - dit is een meldingsinstelling, geen generatie. Tokens worden alleen aan de video zelf uitgegeven: de prijs in tokens is zichtbaar vóór de lancering en als de taak mislukt, wordt het afgeschreven teruggegeven. Er is geen abonnement: nieuwe gebruikers krijgen starttokens voor hun eerste tests.

Waar mee te combineren

• "Batchtaken" — tientallen video's lanceren met één taak; Een webhook elimineert de noodzaak voor handmatige gereedheidscontrole.
• "Mediabibliotheek" — opslag van broncodes en voltooide bestanden.
• "Videovertaling" En "Clipsnijden" — volgende stappen na generatie.

Veelgestelde vragen

Welk adres is geschikt voor een webhook?

Alleen openbare HTTPS. Lokale adressen en HTTP worden niet geaccepteerd: de melding moet over een beveiligd kanaal gaan en uw server moet van buitenaf toegankelijk zijn.

Is het mogelijk om meldingen te ontvangen als er geen server is?

Ja. Klik op “Onze ontvanger vervangen” - de evenementen worden verzameld in het logboek “Bezorgde evenementen” op het tabblad, ze kunnen zonder uw backend worden bekeken.

Wat te doen als de handtekening niet overeenkomt?

Controleer of u HMAC-SHA256 leest uit de onbewerkte verzoektekst (en niet uit de geparseerde JSON) en of u het huidige geheim gebruikt: na opnieuw uitgeven stopt het oude onmiddellijk met werken.

Wordt dit betaald?

Het instellen van webhooks schrijft geen tokens af. Tokens worden alleen besteed aan het genereren van video's - hun prijs is zichtbaar vóór de lancering; Er is geen abonnement, nieuwe gebruikers krijgen starttokens toegekend.