Webhooks "Videoavatarit" -osiossa: ilmoitus palvelimellesi, kun video on valmis
Webhookit osiossa "Videoavatarit" on tapa saada selville, että video on valmis, ilman sivun manuaalista päivittämistä: heti kun video on valmis, POST-pyyntö lähetetään palvelimesi osoitteeseen, ja palvelimesi päättää itse, mitä tehdä seuraavaksi - kirjoittaa linkki tietokantaan, lähettää tiedosto asiakkaalle tai aloittaa seuraava vaihe. Välilehteä tarvitsevat ne, jotka tekevät videoita erissä tai integroivat avatarien luomisen tuotteisiinsa: loputtomien "valmis tai ei vielä" -tarkistusten sijaan yksi lyhyt ilmoitus saapuu juuri oikeaan hetkeen.
Miksi tämä on edes tarpeellista?
Videon renderöinti ei ole välitön toiminto, eikä sitä kannata odottaa avoimella välilehdellä. 7.9.2026 päivättyjen alustamittausten mukaan viiden sekunnin Kling 3.0 -videon 1080p:ssä katsotaan olevan keskimäärin 115 sekuntia, ja 95 %:ssa tapauksista se mahtuu 165:een. Sora 2:lla sama tehtävä kestää keskimäärin noin 145 sekuntia. Jos tarkistat tilan muutaman sekunnin välein, yhdessä videossa näkyy kymmeniä tyhjiä pyyntöjä. Webhook tulee vain kerran - kun tulos todella ilmestyy.
Volyymi puhuu myös puolestaan. Alustan sukupolvilokin mukaan 30 päivän aikana (3.9.–2.10.2026) aloitettiin 3 292 videotehtävää, joista 2 369 suoritettiin onnistuneesti. Videot lasketaan taustalla ja päättyvät eri aikoina - tätä ei voi seurata manuaalisesti, ja siisti ilmoituskäsittelijä ratkaisee ongelman itse.
Mitä "Webhooks"-välilehti tekee?
Kyse on ilmoitusten toimittamisesta ilman taikuutta. Rekisteröit osoitteen, valitset tilatut tapahtumat ja saat tilaussalaisuuden. Rekisteröityjen päätepisteiden luettelo on tallennettu sinne: näet osoitteen, valitut tapahtumat, tilan ja onko päätepisteellä salaisuus. Salaisuus voidaan julkaista uudelleen (vanha lakkaa heti toimimasta) tai päätepiste voidaan poistaa kokonaan.
Tapahtuma tulee vain videoistasi: jonkun muun video ei sammu, vaikka se laskettaisiin samalla hetkellä. Toimitetuista tapahtumista on myös loki - on kätevää tarkistaa, että jotain todella on saapunut palvelimellesi.
Kuinka päästä alkuun - askel askeleelta
- Avaa osio "Videoavatarit" ja webhook-paneeli suorassa osoitteessa /ru/avatars?tab=webhooks.
- Kirjaudu sisään tilillesi: asetus ei ole vieraiden käytettävissä; kun napsautat, kirjautumisikkuna avautuu.
- Kirjoita Päätepisteen osoite -kenttään palvelimesi julkinen HTTPS-osoite, esimerkiksi https://example.com/avatar-webhook. HTTP ei toimi – toimitus ja allekirjoitus on suunniteltu suojatulle kanavalle.
- Merkitse tarvittavat tapahtumat. Jos et valitse mitään, tilaat kaikki tapahtumat kerralla.
- Napsauta "Lisää päätepiste". Välittömästi luomisen jälkeen tilauksen salaisuus tulee näkyviin - kopioi ja tallenna se itsellesi: sitä ei näytetä uudelleen.
- Jos sinulla ei vielä ole omaa palvelinta, napsauta "Vaihda vastaanottimemme" - niin ilmoitukset kerääntyvät toimitettujen tapahtumien lokiin suoraan välilehdelle.
Kuinka varmistaa, että pyyntö on meiltä eikä väärennös
Jokaiseen pyyntöön liittyy allekirjoitusotsikko - tämä on HMAC-SHA256, joka lasketaan pyynnön raakatekstistä salaisuutena. Laske puolellasi sama allekirjoitus ja vertaa: jos se ei täsmää, hylkäämme pyynnön. Vastaanottimemme tekee juuri tämän ja vastaa numerolla 401 väärään allekirjoitukseen. Pidä salaisuus palvelimella, ympäristömuuttujissa, älä asiakaskoodissa.
Mitä tulee pyyntöön
Runko on tavallinen JSON, jossa on tapahtumatyyppi ja entiteettitiedot. Esimerkiksi valmiille videolle tämä on BLK0-tapahtuma, jonka sisällä on videotunniste. Täydellinen luettelo käytettävissä olevista tapahtumatyypeistä näkyy välilehdellä: voit lajitella sen ja jättää vain sen, mitä palvelusi todella tarvitsee.
Kuinka paljon se maksaa
Päätepisteiden rekisteröinti, salainen uudelleenjulkaisu, poistaminen ja tapahtumaloki eivät poista tunnuksia – tämä on ilmoitusasetus, ei luonti. Tokeneita käytetään vain itse videoon: tokenien hinta näkyy ennen julkaisua, ja jos tehtävä epäonnistuu, palautetaan pois kirjattu. Tilausta ei ole: uudet käyttäjät saavat aloitustokeneita ensimmäisistä testeistään.
Mihin yhdistää
- "Erätehtävät" — kymmenien videoiden käynnistäminen yhdellä tehtävällä; Webhook poistaa manuaalisen valmiusohjauksen tarpeen.
- "Mediakirjasto" — lähdekoodien ja valmiiden tiedostojen tallennus.
- "Videon käännös" Ja "leikkeen leikkaus" - Seuraavat askeleet sukupolven jälkeen.
Usein kysytyt kysymykset
Mikä osoite sopii webhookille?
Vain julkinen HTTPS. Paikallisia osoitteita ja HTTP:tä ei hyväksytä: ilmoituksen on mentävä suojatun kanavan kautta ja palvelimesi on oltava käytettävissä ulkopuolelta.
Onko mahdollista saada ilmoituksia, jos palvelinta ei ole?
Kyllä. Napsauta "Korvaa vastaanottimemme" - tapahtumat kerätään välilehden "Toimitetut tapahtumat" -lokiin, ja niitä voi tarkastella ilman taustajärjestelmääsi.
Mitä tehdä, jos allekirjoitus ei täsmää?
Tarkista, että luet HMAC-SHA256:ta raakapyynnön rungosta (eikä jäsennetystä JSON-tiedostosta) ja että käytät nykyistä salaisuutta: uudelleenjulkaisemisen jälkeen vanha lakkaa toimimasta välittömästi.
Onko tämä maksettu?
Webhookien määrittäminen ei poista tunnuksia. Tokeneita käytetään vain videoiden luomiseen - niiden hinta näkyy ennen julkaisua; Tilausta ei ole, uudet käyttäjät saavat aloitustokeneita.