Webhooks i delen "Videoavatarer": varsel til serveren din når videoen er klar

Webhooks i seksjonen "Videoavatarer" er en måte å finne ut at videoen er klar, uten å manuelt oppdatere siden: så snart videoen er fullført, sendes en POST-forespørsel til adressen til serveren din, og serveren din bestemmer selv hva som skal gjøres videre - skriv lenken til databasen, send filen til klienten, eller start neste trinn. Fanen er nødvendig av de som lager videoer i grupper eller integrerer generering av avatarer i produktet sitt: i stedet for endeløse "klar eller ikke ennå"-sjekker, kommer en kort varsling til akkurat det rette øyeblikket.

Hvorfor er dette i det hele tatt nødvendig?

Å gjengi en video er ikke en umiddelbar operasjon, og det er ingen vits i å vente på den i en åpen fane. I følge plattformmålinger datert 09.07.2026 regnes en fem sekunders Kling 3.0-video i 1080p som et gjennomsnitt på 115 sekunder, og i 95 % av tilfellene passer den inn i 165. For Sora 2 tar den samme oppgaven i gjennomsnitt omtrent 145 sekunder. Hvis du sjekker statusen med noen sekunders mellomrom, vises dusinvis av tomme forespørsler i én video; Webhooken kommer bare én gang – når resultatet faktisk vises.

Volumet taler også for seg selv. I følge plattformens generasjonslogg startet 3 292 videooppgaver over 30 dager (3. september – 2. oktober 2026, hvorav 2 369 ble fullført. Videoene telles i bakgrunnen og slutter til forskjellige tider – dette kan ikke spores manuelt, og en ryddig varslingsbehandler løser selv problemet.

Hva gjør «Webhooks»-fanen?

Alt handler om å levere varsler, uten magi. Du registrerer en adresse, velger hvilke arrangementer du vil abonnere på, og mottar en abonnementshemmelighet. Listen over registrerte endepunkter lagres rett der: du kan se adressen, valgte hendelser, status og om endepunktet har en hemmelighet. Hemmeligheten kan frigis på nytt (den gamle slutter umiddelbart å fungere) eller endepunktet kan slettes helt.

Hendelsen kommer bare fra videoene dine: noen andres video vil ikke gå ut, selv om den ble talt i samme øyeblikk. Det er også en logg over leverte hendelser - det er praktisk å sjekke at noe faktisk nådde serveren din.

Hvordan komme i gang – steg for steg

1. Åpen seksjon "Videoavatarer" og webhook panel på direkte adresse /ru/avatars?tab=webhooks.
2. Logg inn på kontoen din: innstillingen er ikke tilgjengelig for gjester; når du klikker, åpnes et påloggingsvindu.
3. I «Endpoint Address»-feltet skriver du inn den offentlige HTTPS-adressen til serveren din, for eksempel https://example.com/avatar-webhook. HTTP vil ikke fungere – levering og signering er designet for en sikker kanal.
4. Merk de nødvendige hendelsene. Hvis du ikke velger noe, vil du abonnere på alle arrangementer samtidig.
5. Klikk "Legg til endepunkt". Umiddelbart etter opprettelsen vil abonnementshemmeligheten vises - kopier og lagre den for deg selv: den vil ikke vises igjen.
6. Hvis du ikke har din egen server ennå, klikker du på "Sett ut vår mottaker" - da vil varslinger samles i loggen over leverte hendelser direkte i fanen.

Hvordan sikre at forespørselen er fra oss og ikke en falsk

Hver forespørsel er ledsaget av en signaturoverskrift - dette er HMAC-SHA256, beregnet fra råteksten til forespørselen som din hemmelighet. På din side, tell den samme signaturen og sammenlign: hvis den ikke stemmer, forkaster vi forespørselen. Vår mottaker gjør akkurat dette og svarer med 401 på feil signatur. Hold hemmeligheten på serveren, i miljøvariabler, og ikke i klientkoden.

Hva kommer i forespørselen

Brødteksten er vanlig JSON med hendelsestype og enhetsdata. For eksempel, for en ferdig video, er dette BLK0-hendelsen med videoidentifikatoren inni. Den fullstendige listen over tilgjengelige hendelsestyper vises i fanen: du kan sortere gjennom den og la bare det tjenesten din virkelig trenger.

Hvor mye koster det

Endepunktregistrering, hemmelig gjenutgivelse, sletting og hendelseslogg skriver ikke av tokens - dette er varslingsinnstilling, ikke generering. Tokens brukes kun på selve videoen: prisen i tokens er synlig før lanseringen, og hvis oppgaven mislykkes, returneres det som ble avskrevet. Det er ikke noe abonnement: nye brukere tildeles startbrikker for sine første tester.

Hva å kombinere med

• "Batchoppgaver" — lanserer dusinvis av videoer med én oppgave; En webhook vil eliminere behovet for manuell beredskapskontroll.
• "Mediebibliotek" — lagring av kildekoder og ferdige filer.
• "Videooversettelse" Og "Klippskjæring" — neste steg etter generasjon.

Ofte stilte spørsmål

Hvilken adresse passer for en webhook?

Kun offentlig HTTPS. Lokale adresser og HTTP godtas ikke: varselet må gå over en sikker kanal, og serveren din må være tilgjengelig fra utsiden.

Er det mulig å motta varsler hvis det ikke er noen server?

Ja. Klikk på "Sett ut vår mottaker" - hendelser vil bli akkumulert i loggen "Leverte hendelser" i fanen, de kan sees uten din backend.

Hva gjør jeg hvis signaturen ikke stemmer?

Sjekk at du leser HMAC-SHA256 fra den rå forespørselsteksten (og ikke fra den analyserte JSON) og at du bruker den gjeldende hemmeligheten: etter utstedelse på nytt, slutter den gamle umiddelbart å fungere.

Er dette betalt?

Å sette opp webhooks avskriver ikke tokens. Tokens brukes kun på videogenerering - prisen deres er synlig før lansering; Det er ikke noe abonnement, nye brukere tildeles startbrikker.