blitzreels-clipping

BlitzReels クリッピング

管理対象のクリップ ステートマシン を使用します。 取り込み、文字起こし、選択、レイアウト、字幕、QA、修復、エクスポートの順序を管理します。

手順

1. ソースを、サポート対象の公開動画 URL またはワークスペースのアセット ID として解決し、選択の意図を明確にします。 指定された時間範囲または候補を使用します。選択が委任されている場合に限り、自動で最適な候補を選択します。 ソースと選択モードが明確になった時点で完了です。
2. 利用可能な操作手段を選択します。バンドルされた MCP clips_create ツールを優先してください。利用できない場合は、 blitzreels agent-context --command "clips create" --json または OpenAPI の /clips オペレーションを使用して、現在の仕様を確認します。 必須の入力、変更の影響、状態フィールドが判明した時点で完了です。
3. 呼び出し元で生成した冪等性キーを指定して作成します。 応答にクリップ ID、プロジェクト ID、状態、next_action が含まれている時点で完了です。
4. MCP バッチの場合は、clips_get を使用して batch.polling に従います。管理対象 API のクリップの場合は、next_action に従って、ポーリング、 再選択、修復、エクスポート、または停止を行います。 次の応答で状態が進むか、終端状態に達した場合にのみ、各遷移が完了します。
5. ユーザーが選択肢を選べる状態にしている場合は、タイトル、フック、範囲、長さ、スコアを含む利用可能な候補を提示し、承認された ID または範囲を再選択します。 選択内容が保存された時点で完了です。
6. レイアウトの意図を検証します。 チュートリアルレイアウトは、画面共有とフェイスカメラの映像が一体化したものに使用します。 インタビューやポッドキャストの映像には、自動、分割、またはフォーカスレイアウトを使用します。 適用したレイアウトとコンテンツの種類が一致した時点で完了です。
7. QA プレビューと警告を確認し、現在の状態で提示されている修復アクションのみを実行します。 QA に合格するか、解決が必要な具体的なブロックが状態に示された時点で完了です。
8. ユーザーの承認を得て、エクスポート可能な状態になってから有料エクスポートを開始します。 終端状態までポーリングし、出力の長さ、アスペクト比、字幕、フレーミング、ダウンロード先を確認します。

手動の分岐

管理対象の状態が手動操作を必要とする具体的なブロックを示している場合に限り、低レベルのプロジェクトメディア、文字起こし、タイムライン、字幕、プレビューの各オペレーションを使用します。

修復後は、低レベルの呼び出しでステートマシンを再構築するのではなく、管理対象のクリップに戻ります。

完了

クリップ ID とプロジェクト ID、選択した範囲、適用したレイアウト、QA 結果、警告、エクスポートの状態、ダウンロード先を返します。

ブロックされている場合は、next_action、ブロックしている正確な状態、必要なユーザーの選択またはシステム状態を返します。 完了には、検証済みの終端出力、または管理対象の状態による明示的なブロックが必要です。