Webhooks im Bereich „Video-Avatare“: Benachrichtigung an Ihren Server, wenn das Video fertig ist

Webhooks im Abschnitt „Video-Avatare“ ist eine Möglichkeit herauszufinden, ob das Video fertig ist, ohne die Seite manuell zu aktualisieren: Sobald das Video fertig ist, wird eine POST-Anfrage an die Adresse Ihres Servers gesendet und Ihr Server entscheidet selbst, was als nächstes zu tun ist – den Link in die Datenbank schreiben, die Datei an den Client senden oder den nächsten Schritt starten. Wer stapelweise Videos erstellt oder die Generierung von Avataren in sein Produkt integriert, braucht den Tab: Statt endloser „Bereit oder noch nicht“-Prüfungen kommt eine kurze Benachrichtigung genau im richtigen Moment.

Warum ist das überhaupt notwendig?

Das Rendern eines Videos ist kein sofortiger Vorgang und es macht keinen Sinn, in einem geöffneten Tab darauf zu warten. Laut Plattformmessungen vom 09.07.2026 gilt ein fünf Sekunden langes Kling 3.0-Video in 1080p als durchschnittlich 115 Sekunden und passt in 95 % der Fälle in 165 Sekunden. Bei Sora 2 dauert die gleiche Aufgabe durchschnittlich etwa 145 Sekunden. Prüft man alle paar Sekunden den Status, tauchen in einem Video Dutzende leere Anfragen auf; Der Webhook kommt nur einmal – wenn das Ergebnis tatsächlich erscheint.

Auch die Lautstärke spricht für sich. Laut dem Generierungsprotokoll der Plattform wurden innerhalb von 30 Tagen (3. September – 2. Oktober 2026) 3.292 Videoaufgaben gestartet, von denen 2.369 erfolgreich abgeschlossen wurden. Die Videos werden im Hintergrund gezählt und enden zu unterschiedlichen Zeitpunkten – manuell lässt sich das nicht nachverfolgen und ein übersichtlicher Benachrichtigungshandler löst das Problem von selbst.

Was macht die Registerkarte „Webhooks“?

Es geht darum, Benachrichtigungen ohne Zauberei zuzustellen. Sie registrieren eine Adresse, wählen aus, welche Veranstaltungen Sie abonnieren möchten, und erhalten ein Abonnementgeheimnis. Die Liste der registrierten Endpunkte wird direkt dort gespeichert: Sie können die Adresse, ausgewählte Ereignisse, den Status und ob der Endpunkt über ein Geheimnis verfügt, sehen. Das Geheimnis kann erneut freigegeben werden (das alte funktioniert sofort nicht mehr) oder der Endpunkt kann vollständig gelöscht werden.

Das Ereignis kommt nur von Ihren Videos: Das Video einer anderen Person wird nicht veröffentlicht, auch wenn es gleichzeitig gezählt wurde. Es gibt auch ein Protokoll der übermittelten Ereignisse – so können Sie bequem überprüfen, ob tatsächlich etwas Ihren Server erreicht hat.

So starten Sie – Schritt für Schritt

1. Abschnitt öffnen „Video-Avatare“ und Webhook-Panel an direkter Adresse /ru/avatars?tab=webhooks.
2. Melden Sie sich bei Ihrem Konto an: Die Einstellung ist für Gäste nicht verfügbar. Beim Anklicken öffnet sich ein Anmeldefenster.
3. Geben Sie im Feld „Endpoint Address“ die öffentliche HTTPS-Adresse Ihres Servers ein, zum Beispiel https://example.com/avatar-webhook. HTTP funktioniert nicht – Zustellung und Signierung sind für einen sicheren Kanal konzipiert.
4. Markieren Sie die gewünschten Ereignisse. Wenn Sie nichts auswählen, werden Sie für alle Veranstaltungen auf einmal abonniert.
5. Klicken Sie auf „Endpunkt hinzufügen“. Unmittelbar nach der Erstellung erscheint das Abonnementgeheimnis – kopieren Sie es und speichern Sie es selbst: Es wird nicht erneut angezeigt.
6. Wenn Sie noch keinen eigenen Server haben, klicken Sie auf „Unseren Empfänger ersetzen“ – dann werden Benachrichtigungen im Protokoll der zugestellten Ereignisse direkt auf der Registerkarte gesammelt.

So stellen Sie sicher, dass die Anfrage von uns stammt und keine Fälschung ist

Jede Anfrage wird von einem Signatur-Header begleitet – dies ist HMAC-SHA256, der aus dem Rohtext der Anfrage als Ihr Geheimnis berechnet wird. Zählen Sie Ihrerseits die gleiche Signatur und vergleichen Sie: Wenn sie nicht übereinstimmt, verwerfen wir die Anfrage. Unser Empfänger macht genau das und antwortet mit 401 auf eine falsche Signatur. Bewahren Sie das Geheimnis auf dem Server, in Umgebungsvariablen und nicht im Clientcode auf.

Was kommt in der Anfrage

Der Textkörper ist reines JSON mit dem Ereignistyp und den Entitätsdaten. Bei einem fertigen Video ist dies beispielsweise das BLK0-Ereignis mit der darin enthaltenen Video-ID. Die vollständige Liste der verfügbaren Ereignistypen wird auf der Registerkarte angezeigt: Sie können sie sortieren und nur das übrig lassen, was Ihr Dienst wirklich benötigt.

Wie viel kostet es

Durch die Endpunktregistrierung, die Neufreigabe von Geheimnissen, das Löschen und das Ereignisprotokoll werden Token nicht abgeschrieben – dies ist eine Benachrichtigungseinstellung, keine Generierung. Token werden nur für das Video selbst ausgegeben: Der Preis in Token ist vor dem Start sichtbar, und wenn die Aufgabe fehlschlägt, wird der abgeschriebene Betrag zurückgegeben. Es gibt kein Abonnement: Neue Benutzer erhalten Startgutscheine für ihre ersten Tests.

Womit kombinieren?

• „Batch-Aufgaben“ — Dutzende Videos mit einer Aufgabe starten; Ein Webhook macht eine manuelle Bereitschaftskontrolle überflüssig.
• „Mediathek“ — Speicherung von Quellcodes und fertigen Dateien.
• „Videoübersetzung“ Und „Clipschneiden“ – nächste Schritte nach der Generation.

Häufig gestellte Fragen

Welche Adresse eignet sich für einen Webhook?

Nur öffentliches HTTPS. Lokale Adressen und HTTP werden nicht akzeptiert: Die Benachrichtigung muss über einen sicheren Kanal erfolgen und Ihr Server muss von außen zugänglich sein.

Ist es möglich, Benachrichtigungen zu erhalten, wenn kein Server vorhanden ist?

Ja. Klicken Sie auf „Ersetzen Sie unseren Empfänger“ – die Ereignisse werden im Protokoll „Zugestellte Ereignisse“ auf der Registerkarte gesammelt und können ohne Ihr Backend angezeigt werden.

Was tun, wenn die Signatur nicht übereinstimmt?

Stellen Sie sicher, dass Sie HMAC-SHA256 aus dem rohen Anforderungstext lesen (und nicht aus dem geparsten JSON) und dass Sie das aktuelle Geheimnis verwenden: Nach der erneuten Ausgabe funktioniert das alte sofort nicht mehr.

Wird das bezahlt?

Durch das Einrichten von Webhooks werden keine Token abgeschrieben. Token werden nur für die Videoerstellung ausgegeben – ihr Preis ist vor der Veröffentlichung sichtbar; Es gibt kein Abonnement, neue Benutzer erhalten Starttokens.