モーション

静止画像を、望ましいモーション効果を記述するテキストプロンプトを使用して動的なビデオに変換します。

URLエンコードされた文字列のプロンプトを受け取ります（motion=your%20motion%20description%20here）。

ビデオの生成には、モデルや再生時間に応じて通常30〜120秒以上かかります。

プロンプト例

モーションプロンプトは大きく2つのグループに分けられます。カメラ系のプロンプトは、静止したシーンの中で視点を移動させます。一方、被写体系のプロンプトは、人物・商品・グラフィックなど、フレーム内にあるものそのものを動かします。

カメラのモーション

• "camera pans left to right, zooms out for aerial drone view"
• "slow zoom in on the subject"
• "camera orbits around the building"
• "gentle pan across the landscape"
• "dramatic zoom out revealing the full scene"

被写体とシーンのモーション

• "the group starts running toward the camera"
• "the model turns slowly toward the camera and smiles"
• "the logo assembles from its individual shapes and settles into place"
• "wind moves through the trees and the water ripples"

パラメータの相互作用

motion パラメータは、他のモーション関連パラメータと組み合わせて使用します：

• motion-duration を使用して生成されるビデオの長さを制御します（デフォルト：5秒）
• motion-seed を使用して、複数のリクエストで再現可能な結果を得られます
• motion-model を使用して、ビデオを生成するAIモデルを選択します（デフォルト：“klingai”）

レンダリングAPIとの組み合わせ

w などのサイズ指定パラメータは、motion リクエストのソース画像には適用されません。

bg-replace のような生成系パラメータは motion と1つのリクエストで組み合わせることができますが、2つの変換は順番に実行されるため、合計の処理時間により非同期処理となります。処理中は 423 が返されるため、完了するまでポーリングする必要があります。

ただし、実際の運用では組み合わせないことを推奨します。組み合わせたリクエストは処理が遅く、キャッシュのウォームアップも難しいうえ、両方の変換の制限をすべて受け継ぎます。bg-replace が失敗した場合、bg-replace-fallback のデフォルトの挙動により元の画像が返され、motion も同時に適用されなくなるため、レスポンスはビデオではなく静止画像を含む 200 になります。デバッグの際は x-imgix-failure-reason レスポンスヘッダーを確認してください。2xx が返ってきただけでは、ビデオを取得できた証拠にはなりません。

まず合成画像をレンダリングして保存し、その保存済み画像を motion でアニメーション化してください。

使用例

以下の各シナリオは、1枚の静止画像を起点とし、motion プロンプトのみを追加したものです。