Kling 비디오 효과 적용
CometAPI를 통해 Kling Video Effects API를 사용하여 POST /kling/v1/videos/effects로 비디오에 스타일 효과를 적용하고 효과 파라미터를 제어합니다.
효과 장면 선택
- 단일 이미지 효과는
effect_scene와input.image,input.duration을 사용합니다 - 2인 상호작용 효과는
effect_scene와 정확히 두 개의 이미지를 포함한input.images를 사용합니다 - 입력 이미지는 Kling의 픽셀 요구사항을 충족해야 하며, 너무 작은 썸네일은 생성 작업에서 거부됩니다
- 정확한 에셋 형식은 선택한 효과에 따라 달라지지만, 요청은 항상 효과 설정을
input내부에 감싸서 전달합니다 - 현재 Kling에서 사용할 수 있는 효과 장면을 사용해야 하며, CometAPI는 알 수 없는
effect_scene값을 거부합니다 - 공개 enum 목록이 고정되어 있다고 가정하지 마세요. 효과 제공 여부는 model 트랙과 장면 계열에 따라 달라집니다
작업 흐름
효과 요청 제출
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.