Kling 動画エフェクトを適用する
CometAPI 経由で Kling Video Effects API を使用し、POST /kling/v1/videos/effects で動画にスタイライズされたエフェクトを適用し、エフェクトパラメータを制御します。
エフェクトシーンを選ぶ
- 単一画像のエフェクトでは、
effect_sceneに加えてinput.imageとinput.durationを使用します - 2人のインタラクションエフェクトでは、
effect_sceneに加えて、ちょうど2枚の画像を含むinput.imagesを使用します - 入力画像は Kling のピクセル要件を満たしている必要があります。小さすぎるサムネイルは生成タスクで拒否されます
- 正確なアセット形式は選択したエフェクトによって異なりますが、リクエストでは常にエフェクト設定を
input内に含めます - Kling で現在利用可能なエフェクトシーンを使用してください。CometAPI は不明な
effect_sceneの値を拒否します - 公開された enum の固定リストに依存しないでください。エフェクトの利用可否は model track や scene family によって変わります
タスクフロー
エフェクトリクエストを送信する
effect_scene と対応する input オブジェクトを送信し、返された task id を保存します。タスクをポーリングする
最終アセットを保存する
承認
Bearer token authentication. Use your CometAPI key.
ボディ
Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.
Effect-specific input payload. Single-image scenes require image and duration; two-person interaction scenes require exactly two images and duration.
- Single-image effect input
- Two-person interaction effect input
Webhook URL for task status notifications. The server sends a callback when the task status changes.
Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.