Apply Kling video effects
Use the Kling Video Effects API via CometAPI to apply stylized effects to videos with POST /kling/v1/videos/effects and control effect parameters.
Choose an effect scene
- Single-image effects use
effect_sceneplusinput.imageandinput.duration - Two-person interaction effects use
effect_sceneplusinput.imageswith exactly two images - Input images must meet Kling pixel requirements; tiny thumbnails are rejected by the generation task
- The exact asset shape depends on the selected effect, but the request always wraps effect settings inside
input - Use an effect scene that is currently available in Kling; CometAPI rejects unknown
effect_scenevalues - Avoid relying on a fixed public enum list; effect availability changes by model track and scene family
Task flow
Submit the effect request
effect_scene plus the matching input object and store the returned task id.Poll the task
Persist the final asset
Authorizations
Bearer token authentication. Use your CometAPI key.
Body
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.