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

효과 장면 선택

  • 단일 이미지 효과는 effect_sceneinput.image, input.duration을 사용합니다
  • 2인 상호작용 효과는 effect_scene와 정확히 두 개의 이미지를 포함한 input.images를 사용합니다
  • 입력 이미지는 Kling의 픽셀 요구사항을 충족해야 하며, 너무 작은 썸네일은 생성 작업에서 거부됩니다
  • 정확한 에셋 형식은 선택한 효과에 따라 달라지지만, 요청은 항상 효과 설정을 input 내부에 감싸서 전달합니다
  • 현재 Kling에서 사용할 수 있는 효과 장면을 사용해야 하며, CometAPI는 알 수 없는 effect_scene 값을 거부합니다
  • 공개 enum 목록이 고정되어 있다고 가정하지 마세요. 효과 제공 여부는 model 트랙과 장면 계열에 따라 달라집니다

작업 흐름

1

효과 요청 제출

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

작업 폴링

효과 작업이 완료될 때까지 Kling task 가져오기를 계속 진행합니다.
3

최종 에셋 보존

안정적인 보관이 필요하다면 완료된 효과 비디오를 다운로드하거나 미러링합니다.
전체 파라미터 참조는 공식 Kling 문서를 확인하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

본문

application/json
effect_scene
string
필수

Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.

input
Single-image effect input · object
필수

Effect-specific input payload. Single-image scenes require image and duration; two-person interaction scenes require exactly two images and duration.

callback_url
string

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

external_task_id
string

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