Kling 4.0の動画編集 は、既存の映像を修正しつつ、動作、タイミング、フレーミング、被写体をモデルに保持させたい場合に使います。リクエストでは、何を変えて何を残すかを明確にする必要があります。新しい生成のヒントとして使う参照動画と、編集対象のソース動画は別のワークフローです。
このガイドではPoYoのKling 4.0 APIと、保存済みで完了したPoYoの例を使います。雪の中を歩くアカギツネを、秋の森林に編集した例です。これはシーン変更の例であり、あらゆる商品の差し替えや人物の同一性を保った編集が成功することを示すものではありません。
ソースと編集結果を見比べる
ソース：冬の野生動物のショット。 記録済みタスク 9DRXDJ5XGW41B9IW、5秒・720pをリクエストし、先頭フレームから生成。記録された請求額：142.5クレジット。
編集結果：秋の森林。 記録済みタスク 84PEDOWZ40C5D7VM、5秒・720pをリクエストし、ソース動画と秋の参照画像を使用。記録された請求額：187クレジット。
編集リクエストの原本とサンプルのメタデータをダウンロードしてください。元のクリップと編集後のクリップを直接比較します。キツネの模様、歩き方、頭の動き、地面との接触、カメラのトラッキング、木の葉の境界はすべて重要です。必要だった動作がぶれてしまっていれば、背景が変わっただけでは十分ではありません。
video_url で編集モードを明示的に選ぶ
次の短縮版テンプレートでフィールドを示します。ダウンロードできるファイルには、記録済みタスクの完全なプロンプトが含まれています。
{
"model": "kling-4.0",
"input": {
"video_url": "https://storage.poyo.ai/blog/kling-4-0-series-20261024/fox-video-d0100387a0e0.mp4",
"reference_image_urls": ["https://storage.poyo.ai/blog/kling-4-0-series-20261024/autumn-reference-0773c88cbeb3.png"],
"prompt": "Edit @Video1 into the autumn woodland shown in @Image1. Replace snow with dry fallen leaves and distant conifers with silver birches. Preserve the same fox, its markings, proportions, walking and head movements, timing, framing and camera tracking. Match shadows and light to the new environment. Return one coherent live-action scene, not a montage or transition.",
"duration": 5,
"resolution": "720p"
}
}
ソースは @Video1、画像参照は @Image1 として指定します。画像で新しい見た目を指定し、ソースが保持すべき動きを提供します。video_url は生成モードよりも優先して編集モードを選択するため、動き参照から新しいショットを生成するはずのリクエストには追加しないでください。
PoYoの編集スキーマが受け付けるもの
ソースの実際の長さは3〜30秒である必要があります。編集には prompt が必須で、720p または 1080p に対応しています。参照画像と画像で定義した被写体は使えますが、image_urls、reference_video_urls、動画で定義した被写体、multi_prompt、aspect_ratio は受け付けません。
サポートされていないフィールドを無効にしようとして、null や空の値で送信しないでください。省略してください。PoYoの現行の編集インターフェースが受け付けるソース動画のフィールドは1つです。より幅広いクリエイター向けプロダクトに複数動画のワークフローがあるからといって、ここで video_urls 配列を作り出す理由にはなりません。更新については最新のAPIドキュメントを確認してください。
制約を明確にした編集プロンプトの書き方
指示を2つの明確な文に分けます。まず、望む変更を明示します。季節の差し替え、ジャケットの変更、商品の差し替えなどです。次に、保持する構造を明示します。被写体の同一性、動作のタイミング、カメラの動き、フレーミング、手を加えないオブジェクトです。
商品の差し替えでは、シルエットが明確なクリーンな参照を用意し、どのオブジェクトを差し替えるかを記述します。手や表面との接触、動く遮蔽物、影、反射を確認してください。モデルは依頼した以上の部分を変更することがあるため、承認前にショット全体を比較し、ブランドの細部を確認しましょう。この記事のキツネの例は、商品差し替えの成功率を測定したものではありません。
最初のテストで、キャラクター、背景、衣装、カメラ、セリフを同時に変更するのは避けましょう。編集が失敗した場合、変更が小さいほど次の原因分析が役立ちます。
ソースと出力の長さからコストを見積もる
編集には動画入力ありの料金が適用されます。PoYoの現在の表示料金では、720pが 課金1秒あたり17クレジット、1080pが 25.5 です。課金秒数は output + max(ceil(source duration), output) です。
ちょうど5秒のソースで5秒の出力をリクエストした場合、見積もりは10課金秒で、720pで170クレジット / $0.85 です。実際のファイルは、リクエストした生成時間よりわずかに長くなることがあります。保存済みの秋のタスクで記録された187クレジットの請求額は11課金秒に相当します。すべての「5秒」のファイルがちょうど5秒だと想定せず、サーバーで計測したソースの長さとタスクの記録を使ってください。
duration を省略した場合、PoYoはアップストリームでは長さを省略したまま、ソースの長さを切り上げた値を出力の課金に使用します。端数のある長さの例については料金ガイドを参照してください。
公開前にレビューする
2つのクリップを同じ時点で見比べてから、通常の速度で再生します。オブジェクトの同一性、動きの連続性、エッジのちらつき、テクスチャの安定性、意図しない内容がないかを確認してください。サウンドトラック全体は別のチェックとして聴いてください。映像が保持されていても、音声が保持されているとは限りません。
参照を使って新しく生成する場合はOmni Referenceガイドを、送信とポーリングについてはAPIチュートリアルを参照してください。公式のクリエイターガイドでは、プラットフォームでの提供状況に応じて、さらに多くの制作ワークフローが紹介されています。