layer-video-fixes

Layer Video の修正

概要

90％まで仕上がったクリップは、新たに生成したクリップより価値があります。再生成すると、すでにうまく機能している動き、タイミング、演技を捨て、新たな問題を抱えることになります。Layer では、ほとんどの単一の欠陥に対応するユースケースが用意されています。そのため、欠陥を特定し、それだけを修正するユースケースを選び、ほかはすべてそのままにしておくことが作業のポイントです。

クリップをゼロから生成するには layer-video を、完成したクリップをつなぎ合わせるには layer-video-timeline を使います。ループ、費用の確認、ポーリングについては layer スキルを参照してください。

ここに記載されている関連スキルが利用可能なスキルにない場合は、ユーザーにインストールを依頼してください （npx skills add layerai/skills --skill <name>）。ユーザーの対応を待てない場合は、ツールのスキーマをもとに進め、不足しているスキルについて明記してください。

クイックリファレンス

各ルートでは、以下のように filter.use_case を設定して list_base_models を呼び出し、最初の結果を選択します。

症状	use_case
クリップが早く終わりすぎる、動作が途中で切れる	video_extend
中間の瞬間が抜けている	insert_video
要素が1つだけ間違っている（色、小道具、背景）	video_editing
映像に映っているオブジェクトが違う	video_object_swap
キャラクターが違う、またはモデルと一致していない	video_character_swap
演技は合っているが、被写体が違う	motion_transfer
ライティングが編集先のシーンと合わない	relight_video
動きがカクつく、またはスローモーションが必要	video_interpolation
納品用として解像度が低すぎる	upscaling
粒状感または圧縮ノイズがある	denoise_video
ぼやけている、またはモーションブラーがある	deblur_video
標準ダイナミックレンジのマスターを HDR にする必要がある	sdr_to_hdr_video

最初の呼び出し前にモデルを確認する

これらのモデルは、生成モデルよりも入力仕様の違いが大きくなっています。スキーマだけでは、修復モデルがソースクリップをどのガイダンススロット（init_video または reference_video）から読み込むのか、置き換える被写体をどこに指定するのか（reference_image、face、または element_* タイプ）は分かりません。選択したモデルに対して get_base_model を呼び出し、一覧にあるスロットを使ってください。別のモデルで使えたからといって、同じスロットを使えると思い込まないでください。修正に2つの入力が同時に必要な場合は、filter.guidance_file_types で検索対象を絞り込みます。たとえば ["init_video", "reference_image"] を指定すると、両方を受け付けるモデルだけが残ります。

ガイダンスファイルは、guidance_files 内の {file_id, type} オブジェクトです。以前の実行で生成したクリップにはすでに file_id があるため、そのまま渡してください。ローカルにある映像素材のみ、request_file_upload_url でアップロードしてください。

元の素材から修復する

モデルを通すたびにディテールが失われます。3つの修正を互いに連鎖させるより、元の素材からそれぞれ修正したほうがきれいに仕上がります。特に顔や細かなテクスチャでは劣化が最初に重なります。元の file_id をマスターとして保持し、修正が互いに独立している場合は、それぞれマスターに適用してください。後の修正で前の修正結果が本当に必要な場合に限り、修正を連鎖させます（内容を確定した後、最後にアップスケールしてください。編集するクリップを先にアップスケールすると、無駄になります）。

クリップの一部だけを修正する場合（最後の2秒をスローモーションにするなど）は、まず render_video_timeline の編集（start_from_in_seconds と duration_in_frames、layer-video-timeline）で該当区間を切り出し、そのファイルを修復してください。

音声、長さ、フレームレート

• 音声。 keep_audio: true を設定すると、修正中も元の音声を引き継げます。設定しない場合、出力が無音になる可能性があるため、納品前に確認してください。
• 長さ。 延長、挿入、補間によってクリップの長さが変わり、置換でも変わることがあります。特に、音楽に合わせて編集されたカットに含まれるクリップの場合は、新しい長さをユーザーに伝えてください。補間によるスローモーションショットは仕様上長くなりますが、置換の結果が短くなった場合は不具合です。
• フレームレート。 fps が反映されるのは、対応するモデルのみです（get_base_model で確認できます）。モデルが無視する値で生成するのではなく、補間で目標のフレームレートにするよう依頼してください。
• サイズ。 リフレームでは、width と height の両方を指定してください。どちらか一方が未指定で、元データが添付されている場合、出力のサイズは元ファイルから引き継がれます。

アップスケールでは、upscale_ratio で倍率（2.0、4.0）を設定します。creativity と resemblance は、創作されたディテールと忠実度のバランスを調整します。顔やテキストを含む映像では、resemblance を高く設定してください。

料金

forge ガイドでは、動画編集の料金は元動画の長さ、アップスケールの料金は元動画のサイズに基づいて算出されます。元データを添付しない見積もりでは異なる実行の料金になるため、estimate_forge_price には execute_forge に渡すものとまったく同じ入力を指定してください。長さの異なるクリップを複数修正する場合、見積もりも複数必要であり、最初の見積もりに件数を掛けてはいけません。作業全体の料金を合算し、20 CUs を超える場合は実行前に確認を求めてください。

実例

「主人公の6秒のクリップは、途中で剣が杖に変わってしまう点以外は完璧です。予告編用に4Kにもしてください。」

1. クリップは前回の実行結果なので、file_id があります。これをマスターとして使います。
2. 1つ目の不具合はオブジェクトの誤りです。filter.use_case: "video_object_swap" を指定して list_base_models を呼び出します。最初の結果を選び、ソーススロットと置換スロットを確認するために get_base_model を呼び出します。
3. 2つ目の不具合はサイズです。filter.use_case: "upscaling" と filter.modality: "video" を指定して list_base_models を呼び出し、get_base_model でスロットと倍率の制限を確認します。
4. どちらも実行前に見積もります。置換については、一覧に記載されたスロットにマスターを添付し、承認済みの剣の静止画を置換素材として指定し、keep_audio: true を設定したうえで、変更点だけを指定するプロンプトを使って estimate_forge_price を呼び出します。「主人公の右手にある杖を、承認済みのロングソードに置き換えてください。動き、タイミング、その他のすべては変更しないでください。」次に、6秒の元動画を対象に upscale_ratio: 2.0 を指定してアップスケールを見積もります。合計料金を提示し、20 CUs を超える場合は承認を待ちます。
5. 置換を execute_forge で実行し、poll_interval_seconds 間隔で get_forge_run を呼び出して状態を確認します。長さが6秒のままで、すべてのフレームで剣が維持されていることを確認します。
6. 置換結果（ステップ5の file_id）をアップスケールします。最後に行うべき修正はこれだけです。状態を確認した後、両方の file_id と、長さに変更があればその内容を報告します。

よくある間違い

• 1つのユースケースで修正できる不具合しかないクリップを、再生成してしまう。
• get_base_model で確認せず、ソーススロットを推測する。
• 個別に行うべき修正をそれぞれマスターからではなく、前の修正結果に重ねて行う。
• アップスケール後にクリップを編集する。
• keep_audio を設定せず、サウンドトラックを失う。
• 長さが変わったことを伝えずに、修正済みクリップを納品する。
• 元データの長さやサイズが異なる複数の修正を、1つの見積もりで料金計算する。
• 変更点だけでなく、シーン全体を説明するプロンプトで修正を依頼する。