API連携で動画制作を自動化する
大量の動画を制作している場合、ボトルネックは編集作業ではなく調整作業になります。何を自動化し、何を人間に任せるべきかをご紹介します。
週に数本の動画であれば手作業でも問題ありません。しかし、数百本となると、編集作業がボトルネックではなくなります。ボトルネックとなるのは、誰かが作業を開始するのを覚えていて、完了したことに気づき、ファイルを移動させ、次の担当者に伝えるといった調整作業です。これこそAPIの出番です。
自動化されたパイプラインの構成
- 新しいものが出現する: アップロードが完了する、録画が終わる、フィードが更新される。
- あなたのコードがソースをクリッピングジョブに送信し、ジョブIDを保存する。
- ジョブが実行される。これにはミリ秒ではなく数分かかるため、何も待機させるべきではない。
- ジョブが完了または失敗したときにWebhookが発火する。
- あなたのハンドラーが動画を取得し、必要な場所にプッシュする。
必要な場合のみポーリングする
数秒ごとにステータスエンドポイントをポーリングする方法は機能し、記述も簡単ですが、最終的にはレート制限を受ける原因となります。Webhookはこれを逆転させます。反応すべきものがあるまで何も実行されません。応答がなかったジョブのセーフティネットとして、低頻度のポーリングを維持し、主要なパスとしては使用しないでください。
公開されたWebhookエンドポイントは発見され、プローブされます。署名付きペイロードを使用すると、リクエストが実際にサービスから送信されたものであることを確認してから処理を実行できます。検証できないものはすべて拒否し、ボディを解析する前にこれを行ってください。
ハンドラーをべき等にする
Webhookは再試行されます。作業がすでに完了した後でネットワークがタイムアウトし、正常に処理された配信が再び届くことがあります。ハンドラーがソーシャルメディアに投稿する場合、重複した配信は重複した投稿になります。ジョブIDに基づいて作業をキー付けし、2回目の配信を何もしない操作にしてください。
自動化すべきでないこと
人間が一度も確認せずに公開することです。自動選択は候補となる瞬間を見つけるのは得意ですが、今日その特定のジョークを投稿するのが不適切であると判断するのは苦手です。有効なパターンは、レビューキューまですべてを自動化し、その後人間が承認するというものです。これにより、スループットを維持しつつ、判断力を保つことができます。
もう一つ、手を出さない方が良いのは、何らかの失敗があった場合にジョブ全体を再実行する再試行ロジックです。失敗にはさまざまな原因があり、取得できないソースは、試行するたびに同じように失敗します。
SpikeReelには、クリップジョブの作成、ステータスの確認、結果の公開またはスケジュール設定を行うためのREST APIがあり、完了時および失敗時には署名付きWebhookが提供されます。リファレンスは/docs/apiにあります。
お持ちの動画からこのようなクリップを作成したいですか？ AI動画クリッピングツール を無料でお試しください。クレジットカードは不要です。