메인 콘텐츠로 건너뛰기
POST
/
kling
/
v1
/
videos
/
effects
Create a Kling video-effects task
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"
  }
}
'
{
  "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.

​
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
필수