Webhooks στην ενότητα "Avatars βίντεο": ειδοποίηση στον διακομιστή σας όταν το βίντεο είναι έτοιμο

Webhooks στην ενότητα "Video Avatars" είναι ένας τρόπος για να μάθετε ότι το βίντεο είναι έτοιμο, χωρίς να ανανεώσετε τη σελίδα με μη αυτόματο τρόπο: μόλις ολοκληρωθεί το βίντεο, αποστέλλεται ένα αίτημα POST στη διεύθυνση του διακομιστή σας και ο ίδιος ο διακομιστής σας αποφασίζει τι θα κάνει στη συνέχεια - γράψτε τον σύνδεσμο στη βάση δεδομένων, στείλτε το αρχείο στον πελάτη ή ξεκινήστε το επόμενο βήμα. Η καρτέλα χρειάζεται για όσους κάνουν βίντεο σε παρτίδες ή ενσωματώνουν τη δημιουργία avatar στο προϊόν τους: αντί για ατελείωτους ελέγχους "έτοιμους ή όχι ακόμα", μια σύντομη ειδοποίηση φτάνει ακριβώς την κατάλληλη στιγμή.

Γιατί είναι ακόμη απαραίτητο αυτό;

Η απόδοση ενός βίντεο δεν είναι μια στιγμιαία λειτουργία και δεν έχει νόημα να το περιμένετε σε μια ανοιχτή καρτέλα. Σύμφωνα με μετρήσεις πλατφόρμας με ημερομηνία 09/07/2026, ένα βίντεο Kling 3.0 πέντε δευτερολέπτων σε ανάλυση 1080p θεωρείται κατά μέσο όρο 115 δευτερόλεπτα και στο 95% των περιπτώσεων χωράει σε 165. Για το Sora 2, η ίδια εργασία διαρκεί κατά μέσο όρο περίπου 145 δευτερόλεπτα. Εάν ελέγχετε την κατάσταση κάθε λίγα δευτερόλεπτα, δεκάδες κενά αιτήματα εμφανίζονται σε ένα βίντεο. Το webhook έρχεται μόνο μία φορά - όταν πραγματικά εμφανίζεται το αποτέλεσμα.

Ο τόμος μιλάει επίσης από μόνος του. Σύμφωνα με το αρχείο καταγραφής παραγωγής της πλατφόρμας, σε διάστημα 30 ημερών (3 Σεπτεμβρίου – 2 Οκτωβρίου 2026), ξεκίνησαν 3.292 εργασίες βίντεο, εκ των οποίων οι 2.369 ολοκληρώθηκαν με επιτυχία. Τα βίντεο καταμετρώνται στο παρασκήνιο και τελειώνουν σε διαφορετικές χρονικές στιγμές - αυτό δεν μπορεί να παρακολουθηθεί με μη αυτόματο τρόπο και ένας καθαρός χειριστής ειδοποιήσεων λύνει το πρόβλημα από μόνος του.

Τι κάνει η καρτέλα "Webhooks";

Όλα έχουν να κάνουν με την παράδοση ειδοποιήσεων, χωρίς μαγεία. Καταχωρίζετε μια διεύθυνση, επιλέγετε σε ποιες εκδηλώσεις θα εγγραφείτε και λαμβάνετε ένα μυστικό συνδρομής. Η λίστα με τα καταχωρημένα τελικά σημεία αποθηκεύεται ακριβώς εκεί: μπορείτε να δείτε τη διεύθυνση, τα επιλεγμένα συμβάντα, την κατάσταση και αν το τελικό σημείο έχει μυστικό. Το μυστικό μπορεί να επανακυκλοφορήσει (το παλιό θα σταματήσει αμέσως να λειτουργεί) ή το τελικό σημείο μπορεί να διαγραφεί εντελώς.

Το συμβάν προέρχεται μόνο από τα βίντεό σας: το βίντεο κάποιου άλλου δεν θα σβήσει, ακόμα κι αν καταμετρήθηκε την ίδια στιγμή. Υπάρχει επίσης ένα αρχείο καταγραφής συμβάντων που παραδόθηκαν - είναι βολικό να ελέγξετε ότι κάτι έφτασε στον διακομιστή σας.

Πώς να ξεκινήσετε - βήμα προς βήμα

1. Ανοίξτε την ενότητα "Video Avatars" και πάνελ webhook στην άμεση διεύθυνση /ru/avatars?tab=webhooks.
2. Συνδεθείτε στον λογαριασμό σας: η ρύθμιση δεν είναι διαθέσιμη στους επισκέπτες. όταν κάνετε κλικ, θα ανοίξει ένα παράθυρο σύνδεσης.
3. Στο πεδίο "Διεύθυνση τελικού σημείου", εισαγάγετε τη δημόσια διεύθυνση HTTPS του διακομιστή σας, για παράδειγμα https://example.com/avatar-webhook. Το HTTP δεν θα λειτουργήσει - η παράδοση και η υπογραφή έχουν σχεδιαστεί για ένα ασφαλές κανάλι.
4. Σημειώστε τα απαιτούμενα συμβάντα. Εάν δεν επιλέξετε τίποτα, θα εγγραφείτε σε όλες τις εκδηλώσεις ταυτόχρονα.
5. Κάντε κλικ στο "Προσθήκη τελικού σημείου". Αμέσως μετά τη δημιουργία, θα εμφανιστεί το μυστικό της συνδρομής - αντιγράψτε και αποθηκεύστε το μόνοι σας: δεν θα εμφανιστεί ξανά.
6. Εάν δεν έχετε ακόμη τον δικό σας διακομιστή, κάντε κλικ στην επιλογή "Αντικατάσταση του δέκτη μας" - τότε οι ειδοποιήσεις θα συγκεντρωθούν στο αρχείο καταγραφής συμβάντων που παραδόθηκαν απευθείας στην καρτέλα.

Πώς να βεβαιωθείτε ότι το αίτημα είναι από εμάς και όχι ψεύτικο

Κάθε αίτημα συνοδεύεται από μια κεφαλίδα υπογραφής - αυτό είναι το HMAC-SHA256, που υπολογίζεται από το μη επεξεργασμένο σώμα του αιτήματος ως μυστικό σας. Από την πλευρά σας, μετρήστε την ίδια υπογραφή και συγκρίνετε: εάν δεν ταιριάζει, απορρίπτουμε το αίτημα. Ο δέκτης μας κάνει ακριβώς αυτό και απαντά με 401 σε λανθασμένη υπογραφή. Κρατήστε το μυστικό στον διακομιστή, σε μεταβλητές περιβάλλοντος και όχι στον κώδικα πελάτη.

Τι μπαίνει στο αίτημα

Το σώμα είναι απλό JSON με τον τύπο συμβάντος και τα δεδομένα οντότητας. Για παράδειγμα, για ένα ολοκληρωμένο βίντεο, αυτό είναι το συμβάν BLK0 με το αναγνωριστικό βίντεο μέσα. Η πλήρης λίστα των διαθέσιμων τύπων συμβάντων εμφανίζεται στην καρτέλα: μπορείτε να την ταξινομήσετε και να αφήσετε μόνο αυτό που πραγματικά χρειάζεται η υπηρεσία σας.

Πόσο κοστίζει

Η εγγραφή τελικού σημείου, η μυστική επανέκδοση, η διαγραφή και το αρχείο καταγραφής συμβάντων δεν διαγράφουν διακριτικά - πρόκειται για ρύθμιση ειδοποιήσεων και όχι δημιουργία. Τα διακριτικά δαπανώνται μόνο για το ίδιο το βίντεο: η τιμή σε διακριτικά είναι ορατή πριν από την κυκλοφορία και εάν η εργασία αποτύχει, επιστρέφεται ό,τι διαγράφηκε. Δεν υπάρχει συνδρομή: απονέμονται στους νέους χρήστες μάρκες έναρξης για τις πρώτες τους δοκιμές.

Με τι να συνδυάσετε

• "Μαζικές εργασίες" — εκκίνηση δεκάδων βίντεο με μία εργασία. Ένα webhook θα εξαλείψει την ανάγκη για χειροκίνητο έλεγχο ετοιμότητας.
• "Βιβλιοθήκη πολυμέσων" — αποθήκευση πηγαίων κωδίκων και τελικών αρχείων.
• "Μετάφραση βίντεο" Και "Κοπή κλιπ" — επόμενα βήματα μετά από γενιά.

Συχνές ερωτήσεις

Ποια διεύθυνση είναι κατάλληλη για webhook;

Μόνο δημόσιο HTTPS. Οι τοπικές διευθύνσεις και το HTTP δεν γίνονται δεκτά: η ειδοποίηση πρέπει να περνά από ένα ασφαλές κανάλι και ο διακομιστής σας πρέπει να είναι προσβάσιμος από το εξωτερικό.

Είναι δυνατή η λήψη ειδοποιήσεων εάν δεν υπάρχει διακομιστής;

Ναί. Κάντε κλικ στην επιλογή "Αντικατάσταση του δέκτη μας" - τα συμβάντα θα συγκεντρωθούν στο αρχείο καταγραφής "Προσδιορισμένα συμβάντα" στην καρτέλα, μπορούν να προβληθούν χωρίς το backend σας.

Τι να κάνετε εάν η υπογραφή δεν ταιριάζει;

Ελέγξτε ότι διαβάζετε το HMAC-SHA256 από το σώμα του πρωτογενούς αιτήματος (και όχι από το αναλυμένο JSON) και ότι χρησιμοποιείτε το τρέχον μυστικό: μετά την επανέκδοση, το παλιό σταματά αμέσως να λειτουργεί.

Αυτό πληρώνεται;

Η ρύθμιση των webhooks δεν διαγράφει διακριτικά. Τα διακριτικά δαπανώνται μόνο για τη δημιουργία βίντεο - η τιμή τους είναι ορατή πριν από την κυκλοφορία. Δεν υπάρχει συνδρομή, απονέμονται στους νέους χρήστες μάρκες έναρξης.