「ビデオ アバター」セクションの Webhook: ビデオの準備ができたらサーバーに通知
セクションの Webhook 「ビデオアバター」 これは、ページを手動で更新せずに、ビデオの準備ができたことを確認する方法です。ビデオが完了するとすぐに、POST リクエストがサーバーのアドレスに送信され、サーバー自体が次に何をするかを決定します (データベースへのリンクを書き込むか、ファイルをクライアントに送信するか、次のステップを開始するか)。このタブは、ビデオをバッチで作成したり、アバターの生成を製品に統合したりする人に必要です。「準備ができているかどうか」を延々とチェックする代わりに、1 つの短い通知が適切なタイミングで届きます。
なぜこれが必要なのでしょうか?
ビデオのレンダリングは即座に実行される操作ではないため、開いたタブでレンダリングを待っていても意味がありません。 2026 年 9 月 7 日付けのプラットフォームの測定によれば、1080p の 5 秒間の Kling 3.0 ビデオは平均 115 秒とみなされ、95% のケースで 165 秒に収まります。Sora 2 の場合、同じタスクには平均約 145 秒かかります。数秒ごとにステータスを確認すると、1 つのビデオに数十の空のリクエストが表示されます。 Webhook は、結果が実際に表示されるときに 1 回だけ送信されます。
ボリュームもそれを物語ります。プラットフォームの生成ログによると、30 日間 (2026 年 9 月 3 日から 10 月 2 日まで) で 3,292 件のビデオ タスクが開始され、そのうち 2,369 件が正常に完了しました。ビデオはバックグラウンドでカウントされ、異なる時間に終了します。これは手動で追跡できません。きちんとした通知ハンドラーが問題自体を解決します。
「Webhook」タブは何をするのでしょうか?
魔法を使わずに、通知を配信するだけです。アドレスを登録し、サブスクライブするイベントを選択して、サブスクリプション シークレットを受け取ります。登録されたエンドポイントのリストはそこに保存されます。アドレス、選択したイベント、ステータス、エンドポイントにシークレットがあるかどうかを確認できます。シークレットは再解放することも (古いシークレットはすぐに動作を停止します)、エンドポイントを完全に削除することもできます。
イベントはあなたのビデオからのみ発生します。たとえ同じ瞬間にカウントされたとしても、他の人のビデオは公開されません。配信されたイベントのログもあります。何かが実際にサーバーに到達したかどうかを確認するのに便利です。
開始方法 – ステップバイステップ
- オープンセクション 「ビデオアバター」 および直接アドレスの Webhook パネル /ru/avatars?tab=ウェブフック.
- アカウントにログインします。この設定はゲストには利用できません。クリックするとログインウィンドウが開きます。
- 「エンドポイント アドレス」フィールドに、サーバーのパブリック HTTPS アドレス (例: https://example.com/avatar-webhook) を入力します。 HTTP は機能しません。配信と署名は安全なチャネル向けに設計されています。
- 必要なイベントにマークを付けます。何も選択しない場合は、すべてのイベントを一度に購読します。
- 「エンドポイントの追加」をクリックします。作成直後に、サブスクリプション シークレットが表示されます。これをコピーして自分用に保存します。再度表示されることはありません。
- 独自のサーバーをまだお持ちでない場合は、「代理受信者」をクリックすると、タブ内の配信されたイベントのログに通知が直接蓄積されます。
リクエストが当社からのものであり、偽物ではないことを確認する方法
各リクエストには署名ヘッダーが付いています。これは HMAC-SHA256 で、リクエストの生の本文からシークレットとして計算されます。あなた側では、同じ署名を数えて比較します。一致しない場合、リクエストは破棄されます。私たちの受信機はまさにこれを行い、間違った署名に対して 401 で応答します。シークレットはクライアント コードではなく、サーバー上の環境変数に保存してください。
リクエストに含まれるもの
本文は、イベント タイプとエンティティ データを含むプレーンな JSON です。たとえば、完成したビデオの場合、これはビデオ識別子を内部に持つ BLK0 イベントです。利用可能なイベント タイプの完全なリストがタブに表示されます。リストを並べ替えて、サービスに本当に必要なものだけを残すことができます。
いくらかかりますか
エンドポイントの登録、シークレットの再解放、削除、およびイベント ログではトークンは消去されません。これは通知設定であり、生成ではありません。トークンはビデオ自体にのみ使用されます。トークンの価格は公開前に表示され、タスクが失敗した場合は、取り消された金額が返されます。サブスクリプションはありません。新規ユーザーには、最初のテストの開始トークンが与えられます。
何を組み合わせるか
- 「バッチタスク」 — 1 つのタスクで数十のビデオを起動します。 Webhook を使用すると、手動で準備状況を制御する必要がなくなります。
- 「メディアライブラリー」 — ソースコードと完成したファイルの保管。
- 「ビデオ翻訳」 そして 「クリップカット」 — 生成後の次のステップ。
よくある質問
Webhook にはどのアドレスが適していますか?
パブリックHTTPSのみ。ローカル アドレスと HTTP は受け入れられません。通知は安全なチャネルを経由する必要があり、サーバーは外部からアクセスできる必要があります。
サーバーがない場合でも通知を受け取ることはできますか?
はい。 「受信者を代理する」をクリックします。イベントはタブの「配信されたイベント」ログに蓄積され、バックエンドなしで表示できます。
署名が一致しない場合はどうすればよいですか?
(解析された JSON からではなく) 未処理のリクエスト本文から HMAC-SHA256 を読み取っていること、および現在のシークレットを使用していることを確認してください。再発行後、古いシークレットはすぐに動作を停止します。
これは有料ですか？
Webhook を設定してもトークンは消去されません。トークンはビデオの生成にのみ使用されます。トークンの価格はリリース前に表示されます。サブスクリプションはなく、新規ユーザーには開始トークンが与えられます。