Webhooks i avsnittet "Videoavatarer": meddelande till din server när videon är klar

Webhooks i avsnittet "Videoavatarer" är ett sätt att ta reda på att videon är klar, utan att manuellt uppdatera sidan: så snart videon har slutförts skickas en POST-begäran till adressen till din server, och din server bestämmer själv vad som ska göras härnäst - skriv länken till databasen, skicka filen till klienten eller starta nästa steg. Fliken behövs av de som gör videor i partier eller integrerar genereringen av avatarer i sin produkt: istället för oändliga "klara eller inte ännu"-kontroller kommer en kort notifikation i exakt rätt ögonblick.

Varför är detta ens nödvändigt?

Att rendera en video är inte en omedelbar operation, och det är ingen idé att vänta på den på en öppen flik. Enligt plattformsmätningar daterade 2026-07-09 anses en fem sekunder lång Kling 3.0-video i 1080p vara ett genomsnitt på 115 sekunder, och i 95 % av fallen passar den in i 165. För Sora 2 tar samma uppgift i genomsnitt cirka 145 sekunder. Om du kontrollerar statusen med några sekunders mellanrum visas dussintals tomma förfrågningar i en video; Webhook kommer bara en gång – när resultatet faktiskt dyker upp.

Volymen talar också för sig själv. Enligt plattformens generationslogg startade 3 292 videouppgifter under 30 dagar (3 september – 2 oktober 2026), varav 2 369 slutfördes framgångsrikt. Videorna räknas i bakgrunden och slutar vid olika tidpunkter - detta kan inte spåras manuellt, och en snygg aviseringshanterare löser själva problemet.

Vad gör fliken "Webhooks"?

Allt handlar om att leverera aviseringar, utan magi. Du registrerar en adress, väljer vilka evenemang du vill prenumerera på och får en prenumerationshemlighet. Listan över registrerade slutpunkter lagras precis där: du kan se adressen, valda händelser, status och om slutpunkten har en hemlighet. Hemligheten kan släppas på nytt (den gamla slutar omedelbart att fungera) eller så kan slutpunkten raderas helt.

Händelsen kommer bara från dina videor: någon annans video kommer inte att slockna, även om den räknades i samma ögonblick. Det finns också en logg över levererade händelser - det är bekvämt att kontrollera att något faktiskt nådde din server.

Så här kommer du igång - steg för steg

1. Öppna avsnitt "Videoavatarer" och webhook panel på direkt adress /ru/avatars?tab=webhooks.
2. Logga in på ditt konto: inställningen är inte tillgänglig för gäster; när du klickar på den öppnas ett inloggningsfönster.
3. I fältet "Endpoint Address" anger du den offentliga HTTPS-adressen för din server, till exempel https://example.com/avatar-webhook. HTTP kommer inte att fungera - leverans och signering är designade för en säker kanal.
4. Markera nödvändiga händelser. Om du inte väljer något kommer du att prenumerera på alla evenemang på en gång.
5. Klicka på "Lägg till slutpunkt". Omedelbart efter skapandet kommer prenumerationshemligheten att visas - kopiera och spara den till dig själv: den kommer inte att visas igen.
6. Om du inte har din egen server ännu, klicka på "Ersätt vår mottagare" - då kommer aviseringar att samlas i loggen över levererade händelser direkt i fliken.

Hur man säkerställer att förfrågan kommer från oss och inte är en bluff

Varje begäran åtföljs av en signaturrubrik - det här är HMAC-SHA256, beräknad från den råa delen av begäran som din hemlighet. På din sida, räkna samma signatur och jämför: om den inte stämmer, ignorerar vi begäran. Vår mottagare gör precis detta och svarar med 401 på en felaktig signatur. Behåll hemligheten på servern, i miljövariabler och inte i klientkoden.

Vad kommer i begäran

Brödtexten är vanlig JSON med händelsetyp och enhetsdata. Till exempel, för en färdig video, är detta händelsen BLK0 med videoidentifieraren inuti. Den fullständiga listan över tillgängliga händelsetyper visas på fliken: du kan sortera igenom den och bara lämna kvar det som din tjänst verkligen behöver.

Hur mycket kostar det

Slutpunktsregistrering, hemlig återutgivning, radering och händelselogg skriver inte av tokens - detta är aviseringsinställning, inte generering. Tokens spenderas endast på själva videon: priset i tokens är synligt före lanseringen, och om uppgiften misslyckas returneras det som avskrivits. Det finns ingen prenumeration: nya användare tilldelas startsymboler för sina första tester.

Vad man ska kombinera med

• "Batchuppgifter" — lansera dussintals videor med en uppgift; En webhook kommer att eliminera behovet av manuell beredskapskontroll.
• "Mediebibliotek" — Lagring av källkoder och färdiga filer.
• "Videoöversättning" Och "klippning" — nästa steg efter generation.

Vanliga frågor

Vilken adress är lämplig för en webhook?

Endast offentlig HTTPS. Lokala adresser och HTTP accepteras inte: meddelandet måste gå över en säker kanal, och din server måste vara tillgänglig från utsidan.

Är det möjligt att få aviseringar om det inte finns någon server?

Ja. Klicka på "Ersätt vår mottagare" - händelserna kommer att samlas i loggen "Leverade händelser" på fliken, de kan ses utan din backend.

Vad ska man göra om signaturen inte stämmer?

Kontrollera att du läser HMAC-SHA256 från råbegäran (och inte från den analyserade JSON) och att du använder den aktuella hemligheten: efter återutgivning slutar den gamla omedelbart att fungera.

Är detta betalt?

Att ställa in webhooks skriver inte av tokens. Tokens spenderas endast på videogenerering - deras pris är synligt före lansering; Det finns ingen prenumeration, nya användare tilldelas startpoletter.