소개
Kling O3 영상 편집은 아무것도 없는 상태에서 생성하는 대신 이미 가진 영상을 바꿉니다. 원본 클립을 업로드하고 바뀔 부분—계절, 의상, 배경, 스타일—만 설명하는 프롬프트를 쓰세요. 언급하지 않은 것은 촬영된 그대로 유지됩니다. 새 캐릭터, 의상, 사물을 가져오기 위해 최대 4장의 레퍼런스 사진을 선택적으로 추가할 수 있습니다. 결과물은 원본 클립과 정확히 같은 길이(3~10초)로, 720p 또는 1080p로 나옵니다.
시작 소재별 Kling O3 모드 선택
| 시작 시점에 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면뿐 | Kling O3 텍스트→영상 |
| 승인된 첫 프레임 | Kling O3 이미지→영상 |
| 최대 7장의 레퍼런스 사진 | Kling O3 레퍼런스→영상 |
| 이미 가진 영상 | Kling O3 영상 편집 |
핵심 기능 및 하이라이트
지정한 것만 바뀝니다
프롬프트는 완전한 장면 묘사가 아니라 변경 사항 목록입니다. 계절을 눈으로 바꾸거나 의상을 겨울 코트로 바꾸라고 말하면, 원본 클립의 프레이밍, 움직임, 속도감은 그대로 유지됩니다.
길이와 형태는 원본을 따릅니다
설정할 길이 필드가 따로 없습니다. 편집된 클립은 업로드한 영상의 길이(3~10초)를 그대로 따르고, 해상도는 다른 세 모드에서 쓸 수 있는 4K가 아니라 720p 또는 1080p로 제한됩니다.
원본에 없던 것을 위한 레퍼런스 사진
원본 클립에 없는 새로운 요소—특정 의상, 소품, 룩—를 도입해야 하는 편집이라면 프롬프트에서 설명한 변경 사항과 함께 최대 4장의 레퍼런스 이미지를 추가하세요.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 바꿀 것—피사체, 의상, 배경, 스타일, 날씨—을 말하세요. 언급하지 않은 것은 편집된 클립에서도 그대로 유지됩니다. 1자 이상 · 2500자 이하 |
video_url | 예 | 편집할 원본 클립으로 3~10초, 짧은 쪽 변이 최소 약 720픽셀은 되어야 합니다. 편집된 결과물은 이 클립과 정확히 같은 길이로 나옵니다. |
elements | 아니요 | 편집된 클립에 넣을 이름 붙은 피사체를 하나 지정합니다. 이름, 한 줄 설명, 같은 인물이나 사물의 사진 2 |
reference_image_urls | 아니요 | 편집에 새 캐릭터, 의상, 사물, 스타일을 가져오기 위한 레퍼런스 사진으로 선택 사항이며 최대 4장입니다. JPEG 또는 PNG. 1개 이상 · 4개 이하 |
resolution | 아니요 | 720p 또는 1080p입니다. 상위 등급일수록 초당 비용이 더 듭니다. |
keep_original_audio | 아니요 | 원본 클립에 원래 있던 소리를 편집 결과에 남깁니다. 기본으로 켜져 있습니다. 기본값: |
요금
원본 영상 길이(3~10초)의 초당, 해상도별로 과금됩니다.
| 사양 | 요금 |
|---|---|
| $0.1252 / 초 |
| $0.168 / 초 |
활용 사례
다른 계절이나 날씨로 클립 재사용하기
이미 마음에 드는 샷을 가져와 계절이나 날씨만 바꾸세요—여름을 눈으로, 맑은 하늘을 비로—전체 장면을 다시 촬영하거나 다시 생성할 필요가 없습니다.
승인된 테이크의 의상이나 배경 바꾸기
클립의 프레이밍과 연기는 맞지만 의상이나 피사체 뒤의 장소를 바꿔야 할 때, 영상 편집은 그 요소만 업데이트합니다.
다른 곳에서 만든 클립 스타일 바꾸기
이 모델이나 다른 모델의 텍스트→영상, 이미지→영상 결과물을 가져와 프롬프트로, 필요하면 레퍼런스 사진의 안내를 받아 다른 시각적 스타일로 밀어붙이세요.
프롬프트 가이드 및 실전 팁
장면이 아니라 변경 사항 목록으로 쓰세요
클립에 이미 있는 것에서 시작해 차이점만 말하세요. "계절을 눈으로 바꿔라", "그에게 대신 차콜색 코트를 입혀라" 처럼요. 완전한 장면 묘사는 의도한 것보다 모델이 더 많이 다시 만들게 만듭니다.
원본 영상의 크기를 먼저 확인하세요
원본은 짧은 쪽 변이 대략 720픽셀 이상이어야 합니다. 너무 작은 클립은 생성이 시작되기 전에 거부되므로, 레퍼런스 사진까지 포함된 작업이라면 미리 확인하세요.
편집이 새로 도입하는 것에만 레퍼런스를 추가하세요
레퍼런스 사진은 원본 클립에 없는 것—의상, 사물, 룩—을 샷에 들여오기 위한 것입니다. 계절이나 색조 변경처럼 순수하게 묘사적인 변경이라면 대개 프롬프트만으로 충분합니다.
인물별로 다른 의상을 명확히 지정하세요
클립에 두 명 이상이 있고 각자 다른 새 의상이 필요하다면, "앞의 라이더는 남색 코트, 뒤는 회색 코트" 처럼 따로 이름을 붙여 지정하세요. 지정하지 않으면 저희 겨울 테스트에서는 두 라이더가 같은 코트를 받았습니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "kling/o3/video-edit",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.












