Webhooks i afsnittet "Videoavatarer": meddelelse til din server, når videoen er klar

Webhooks i afsnittet "Videoavatarer" er en måde at finde ud af, at videoen er klar på, uden at opdatere siden manuelt: Så snart videoen er færdig, sendes en POST-anmodning til adressen på din server, og din server bestemmer selv, hvad der skal gøres næste gang - skriv linket til databasen, send filen til klienten, eller start næste trin. Fanen er nødvendig for dem, der laver videoer i batches eller integrerer genereringen af ​​avatarer i deres produkt: I stedet for endeløse "klar eller ej endnu"-tjek, ankommer en kort notifikation på præcis det rigtige tidspunkt.

Hvorfor er dette overhovedet nødvendigt?

Gengivelse af en video er ikke en øjeblikkelig handling, og det nytter ikke at vente på det i en åben fane. Ifølge platformsmålinger dateret 09/07/2026 betragtes en fem sekunders Kling 3.0-video i 1080p som et gennemsnit på 115 sekunder, og i 95 % af tilfældene passer den ind i 165. For Sora 2 tager den samme opgave i gennemsnit omkring 145 sekunder. Hvis du tjekker status med få sekunders mellemrum, vises snesevis af tomme anmodninger i én video; Webhooken kommer kun én gang – når resultatet rent faktisk dukker op.

Volumen taler også for sig selv. Ifølge platformens generationslog startede 3.292 videoopgaver over 30 dage (3. september – 2. oktober 2026), hvoraf 2.369 blev gennemført med succes. Videoerne tælles i baggrunden og slutter på forskellige tidspunkter - dette kan ikke spores manuelt, og en pæn notifikationshandler løser selv problemet.

Hvad gør fanen "Webhooks"?

Det handler om at levere notifikationer uden magi. Du registrerer en adresse, vælger, hvilke begivenheder du vil abonnere på, og modtager en abonnementshemmelighed. Listen over registrerede endepunkter gemmes lige der: du kan se adressen, valgte hændelser, status og om endepunktet har en hemmelighed. Hemmeligheden kan frigives igen (den gamle stopper straks med at virke), eller slutpunktet kan slettes helt.

Begivenheden kommer kun fra dine videoer: en andens video forsvinder ikke, selvom den blev talt i samme øjeblik. Der er også en log over leverede hændelser - det er praktisk at kontrollere, at noget rent faktisk nåede din server.

Sådan kommer du i gang - trin for trin

1. Åbn sektion "Videoavatarer" og webhook panel på direkte adresse /ru/avatars?tab=webhooks.
2. Log ind på din konto: indstillingen er ikke tilgængelig for gæster; når der klikkes, åbnes et login-vindue.
3. I feltet "Endpoint Address" skal du indtaste den offentlige HTTPS-adresse på din server, for eksempel https://example.com/avatar-webhook. HTTP fungerer ikke - levering og signering er designet til en sikker kanal.
4. Marker de nødvendige begivenheder. Hvis du ikke vælger noget, vil du blive tilmeldt alle arrangementer på én gang.
5. Klik på "Tilføj slutpunkt". Umiddelbart efter oprettelsen vises abonnementshemmeligheden - kopier og gem den til dig selv: den vises ikke igen.
6. Hvis du ikke har din egen server endnu, skal du klikke på "Substituer vores modtager" - så vil notifikationer blive akkumuleret i loggen over leverede hændelser direkte i fanen.

Sådan sikrer du dig, at anmodningen er fra os og ikke en falsk

Hver anmodning er ledsaget af en signaturoverskrift - dette er HMAC-SHA256, beregnet ud fra den rå tekst af anmodningen som din hemmelighed. På din side, tæl den samme signatur og sammenlign: Hvis den ikke matcher, kasserer vi anmodningen. Vores modtager gør præcis dette og svarer med 401 på en forkert signatur. Hold hemmeligheden på serveren, i miljøvariabler og ikke i klientkoden.

Hvad kommer i anmodningen

Brødteksten er almindelig JSON med hændelsestypen og enhedsdata. For en færdig video er dette f.eks. BLK0-hændelsen med video-id'et indeni. Den fulde liste over tilgængelige hændelsestyper vises på fanen: du kan sortere gennem den og kun lade det, din tjeneste virkelig har brug for.

Hvor meget koster det

Slutpunktregistrering, hemmelig genudgivelse, sletning og hændelseslog afskriver ikke tokens - dette er meddelelsesindstilling, ikke generering. Tokens bruges kun på selve videoen: Prisen i tokens er synlig før lanceringen, og hvis opgaven mislykkes, returneres det afskrevne. Der er intet abonnement: nye brugere tildeles startpoletter til deres første test.

Hvad skal man kombinere med

• "Batch opgaver" — lancering af snesevis af videoer med én opgave; En webhook vil eliminere behovet for manuel beredskabskontrol.
• "Mediebibliotek" — opbevaring af kildekoder og færdige filer.
• "Videooversættelse" Og "Klip klipning" — næste skridt efter generation.

Ofte stillede spørgsmål

Hvilken adresse er egnet til en webhook?

Kun offentlig HTTPS. Lokale adresser og HTTP accepteres ikke: meddelelsen skal gå over en sikker kanal, og din server skal være tilgængelig udefra.

Er det muligt at modtage notifikationer, hvis der ikke er nogen server?

Ja. Klik på "Substituer vores modtager" - begivenheder vil blive akkumuleret i "Leverede begivenheder"-loggen på fanen, de kan ses uden din backend.

Hvad skal man gøre, hvis signaturen ikke stemmer overens?

Tjek, at du læser HMAC-SHA256 fra den rå anmodningstekst (og ikke fra den parsede JSON), og at du bruger den aktuelle hemmelighed: efter genudstedelse stopper den gamle med det samme med at virke.

Er dette betalt?

Opsætning af webhooks afskriver ikke tokens. Tokens bruges kun på videogenerering - deres pris er synlig før lancering; Der er intet abonnement, nye brugere tildeles startpoletter.