blitzreels-video-editing

BlitzReels REST 動画編集

ローカルで blitzreels コマンドを利用できる場合は、CLI スキルを使用してください。 このスキルでは、REST による直接編集と統合コードを扱います。

ワークフロー

1. 簡潔な機能インデックスを読み込み、必要な OpenAPI オペレーションのみを読み込みます。
2. プロジェクトと、範囲を限定したタイムラインのコンテキストを読み込みます。 字幕の単語、メディア、その他の大規模なコレクションは、関連する時間範囲の分だけ読み込みます。
3. 読み取り結果から安定した ID を選択します。 変更後のタイムライン状態では、それ以前の状態から ID を再利用しないでください。
4. 変更全体を担う、最も上位のオペレーションを選択します。
   • 音声の削除：字幕の連動リップルを伴うタイムラインカット。
   • 字幕の修正：適切に単語のテキストを変更、結合、分割、削除、タイミング変更、またはブロックのパッチ適用。
   • ビジュアルの配置：現在のキャンバスサイズを使ったタイムラインへのメディア挿入または変形。
   • 編集可能なテキスト：コンテンツアイテム。
5. オペレーションがドライランまたはプランに対応している場合、リスクのある書き込みをプレビューします。
6. コントラクトで受け付けられる場合は、冪等性キーを指定して変更を実行します。
7. タイムラインを再度読み込み、変更した各区間のプレビューフレームをレンダリングします。
8. ビジュアルを確認し、有料レンダリングの明示的な承認を得てから、エクスポートを開始します。
9. エクスポートが終端状態になるまでポーリングし、出力メタデータを確認します。

編集ルール

• 明示的な座標を指定する前に、配置プリセットを優先してください。
• セーフエリアをレイアウト上の制約として扱い、レンダリングしたフレームで確認してください。
• ロゴやオーバーレイには、利用可能な中で最も高解像度のソースを使用してください。
• フォントファミリーを設定する前に、対応フォントを一覧表示してください。
• ワークスペースまたはスタイルのうち、変更するフィールドのみをパッチしてください。
• 部分的な失敗は、要求したすべての項目が処理されたことを確認するまで失敗として扱ってください。

失敗時の分岐

競合または古い ID が発生した場合、保留中の編集を破棄してコンテキストを更新し、対象を選び直してください。 バッチ処理が部分的に失敗した場合は、失敗した各項目を報告し、成功した項目を確認してから、失敗した項目のみを再試行してください。

完了

影響を受けた ID、変更のレシート、警告、プレビューの根拠、エクスポートのステータスを返してください。 API が書き込みを受け付けても、その結果のフレームまたはタイムラインを確認していなければ、タスクは完了していません。