エージェント向けClipReel

AIエージェントで動画編集を自動化

ClipReel REST APIを使用して、製品デモ、SNS向けショート動画、キャプション追加、レビュー用編集などの動画生成ジョブを自動化します。

エージェントを接続する

実際の映像で編集を試す

8秒間のソース映像と6秒間の編集済み動画を比較してみましょう。リクエスト送信準備済みのサンプルプロジェクトを開きます。

最初の2秒をカットし、タイトル「A day on the ridge」を3秒間追加し、色調を寒色系に調整し、最後の0.5秒でフェードアウトします。
ClipReelで試す ソースクリップをダウンロード
元の映像
カット、タイトル、フェード

ClipReelに接続

スコープ付きトークンを作成し、として保存します。 CLIPREEL_API_TOKENそしてクライアントを設定してください。チュートリアルではプロジェクトの読み取り、書き込み、およびジョブ用トークンを使用します。

curl https://www.clipreel.com/api/v1/projects \
  -H "Authorization: Bearer $CLIPREEL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Product walkthrough"}'

製品デモを段階的に自動化

ローンチごとにプロジェクトを作成し、元の画面録画をインポートします。明確な冒頭、目標とする長さ、字幕の要件を指定してedit_by_promptをキューに入れます。各ジョブにべき等性キーを送信することで、再試行時に元の結果を復元できます。

承認済みカットからソーシャルメディア用バージョンを作成

各export_videoリクエストで同じ保存済みリビジョンをピン留めし、16:9、9:16、または正方形用に個別のキーを送信します。ジョブのリソースをポーリングして次のステータスを確認します。編集リンクを使用して同じフッテージ、カット、字幕、エフェクトを開き、別のエクスポートを依頼します。

統合におけるエラーと権限の処理

スコープ付きアカウントトークンを使用し、署名済みURLに直接アップロードします。完了を読み取る前に、生のHTTPリクエストボディに対してコールバック署名を検証します。安定したジョブIDを使用して再試行を処理します。パートナーアプリの場合は、その正確なオリジンとプロジェクトに対して、スコープ付き埋め込みセッションを1つ作成します。

RESTワークフロー

JSONを送信: Authorization: Bearer $CLIPREEL_API_TOKENファイルインポートの場合は、宣言されたファイル名、メディアタイプ、バイト長、および期間を送信します: POST /tools/import_media返されたURLに対して、同じコンテンツタイプと長さでファイルをアップロードします。

ローンチカットをドラフト作成

POST https://www.clipreel.com/api/v1/tools/edit_by_prompt
{
  "projectId": "PROJECT_ID",
  "prompt": "Remove pauses, add captions, and cut a 45-second launch video",
  "idempotencyKey": "launch-v1-edit"
}

字幕キューを生成またはインポート

キューに追加 POST /tools/transcribe_video プロジェクトIDで。次にポーリング GET /jobs/JOB_ID. 戻り値のパス result.cues to POST /tools/add_captions のようなスタイルで white or lime. 自分で提供するタイムスタンプには、同じキューオブジェクトを使用してください。

縦型カットを書き出す

POST https://www.clipreel.com/api/v1/tools/export_video
{
  "projectId": "PROJECT_ID", "revision": 7,
  "aspect": "9:16", "resolution": "720p",
  "idempotencyKey": "launch-v1-vertical", "webhookId": "WEBHOOK_ID"
}

署名付きコールバックを検証

HTTPSエンドポイントを以下で登録 POST /webhooks を使い {"url":"https://partner.example.com/clipreel"}. 返された署名シークレットを保存します。Unixタイムスタンプ、ピリオド、生の要求ボディに対してHMAC-SHA256を計算します。定数時間で以下と比較してください v1 の中にある ClipReel-Signature ヘッダー。5分以上経過したタイムスタンプは拒否してください。以下を処理します ClipReel-Delivery を重複排除IDとして使用します。最新の署名付きメディアリンクをポーリングします。

同じ編集可能なプロジェクトを埋め込む

POST https://www.clipreel.com/api/v1/embed-sessions
{
  "projectId": "PROJECT_ID",
  "origin": "https://partner.example.com",
  "permission": "edit"
}

を読み込む embedUrl 登録されたオリジンのiframe内。セッションは20分間有効で、トークンの権限を継承します。以下を設定してください permission to view レビュー専用セッション用。ClipReelで開くと、エディタはフルワークスペース内のプライベートプロジェクトに戻ります。

クライアント設定とワークフロー

Claude Codeでの動画編集

Claude Codeに録画データを編集可能なカットに変換するよう依頼します。プレビューを確認後、ClipReelで同じプロジェクトを開きます。

Claude Codeのセットアップ
最初の2秒間をカットする

動画編集MCPサーバー

MCPクライアントをClipReelに接続し、プロジェクト作成、タイムライン編集の提案、プレビュー確認、編集可能データの書き出しを行います。

MCPのセットアップ

Cursorから製品動画を編集

CursorとClipReelを使用して、製品紹介の録画を、キャプション付きで複数のエクスポート形式に対応した編集可能な動画に変換します。

Cursorのワークフロー

AIエージェントで動画編集を自動化

ClipReel REST APIを使用して、製品デモ、SNS向けショート動画、キャプション追加、レビュー用編集などの動画生成ジョブを自動化します。

REST APIガイド

ホスト型ジョブはClipReelプランの対象です。 プラン別のチャット編集履歴と動画クレジットを確認する