비디오 효과

CometAPI를 통해 Kling Video Effects API를 사용하여 POST /kling/v1/videos/effects로 비디오에 스타일 효과를 적용하고 효과 파라미터를 제어하세요.

POST /kling/v1/videos/effects

Create a Kling video-effects task

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/effects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "effect_scene": "hug",
  "input": {
    "model_name": "kling-v1-6",
    "mode": "std",
    "images": [
      "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452",
      "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/5eef15e03a70e1fa80732808a2f50f3f.png?x-kcdn-pid=112452"
    ],
    "duration": "10"
  }
}
'

200

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "2032273960331935744",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773366844624,
    "updated_at": 1773366844624
  }
}

이 엔드포인트를 사용하면 Kling의 사전 설정 효과 장면 중 하나를 적용해 입력 자산을 새로운 짧은 비디오로 변환할 수 있습니다.

​

효과 장면 선택

• hug와 kiss는 2인 상호작용 프리셋입니다
• fuzzyfuzzy, squish, expansion, heart_gesture는 스타일화된 프리셋 효과입니다
• 정확한 자산 형식은 효과에 따라 달라지지만, 요청은 항상 provider별 설정을 input 내부에 감싸서 전달합니다

​

작업 흐름

1. 효과 요청 제출

   effect_scene와 이에 맞는 input 객체를 전송하고 반환된 task id를 저장합니다.

2. 작업 폴링

   효과 작업이 완료될 때까지 개별 조회를 계속 진행하세요.

3. 최종 자산 저장

   안정적인 보관이 필요하다면 완료된 효과 비디오를 다운로드하거나 미러링하세요.

2026-03-13의 실시간 검증에서 callback_url 또는 external_task_id 없이도 hug 요청이 정상적으로 수락되었고, task_status: submitted가 반환되는 것이 확인되었습니다.

전체 파라미터 참조는 공식 Kling 문서를 확인하세요.

인증

Authorization · string · header · 필수

Bearer token authentication. Use your CometAPI key.

본문

application/json

effect_scene · enum<string> · 기본값: hug · 필수

Preset effect to apply. Each effect defines a specific animation or interaction style.

사용 가능한 옵션: fuzzyfuzzy, squish, expansion, hug, kiss, heart_gesture

input · object · 필수

Effect-specific input payload. Most interaction effects use one or more image URLs plus model settings.

Show child attributes

callback_url · string · 기본값: https://example.com/webhook

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id · string · 기본값: my-kling-effect-task-001

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

응답

200 - application/json

Task accepted.

code · integer · 필수

Error code; specific error code definition

message · string · 필수

Error message

data · object · 필수

Show child attributes