소개
Kling 4.0 Flash 영상 편집은 기존 클립과 필수 수정 지시에서 시작합니다. 3~20초 원본을 제공하고 필요에 따라 레퍼런스 이미지를 최대 10장 추가합니다. 720p 결과는 원본의 장면, 피사체, 동작, 카메라 움직임을 유지하면서 설명한 수정을 적용합니다.
출력 길이는 원본을 따르며 20초를 넘는 원본은 해당 지점에서 잘립니다. 저희 테스트에서 천문대 의상 편집은 5.04초 원본을 5.04초 결과로 유지했습니다. 기본적으로 원본 사운드를 보존하며, 동기화된 오디오를 새로 생성하려면 keep_original_audio를 false로 지정합니다.
핵심 기능 및 하이라이트
- 기존 연기와 카메라 움직임을 바탕으로 시각적 수정을 적용합니다.
- 특정한 시각 자료가 필요할 때는 레퍼런스 이미지를 최대 10장 더합니다.
- 원본의 타이밍을 출력에도 유지하며 원본 소재는 최대 20초까지 사용합니다.
- 기본 설정으로 원래 사운드트랙을 유지하거나 새 동기화 오디오를 생성합니다.
- auto 구도 또는 네 가지 지원 화면비 중 하나로 720p 결과를 받습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 편집 지시를 반드시 입력하며 미리 정해진 텍스트는 없습니다. 수정 내용과 유지할 장면, 피사체, 동작, 카메라 움직임을 설명합니다. 1자 이상 |
video_url | 예 | 3~20초 원본 클립 1개의 URL이 필수이며 기본 원본은 없습니다. 긴 입력은 20초에서 잘립니다. 1자 이상 |
reference_image_urls | 아니요 | 필요하면 이미지 URL을 최대 10개 추가해 편집을 안내합니다. 업로드한 순서대로 @Image1, @Image2 등으로 지정하며 이미지 레퍼런스로 추가 요금이 발생하지 않습니다. 1개 이상 · 10개 이하 |
aspect_ratio | 아니요 | auto는 원본 영상의 화면비를 따르며, 출력 구도를 16:9, 9:16, 1:1, 21:9로 정할 수도 있습니다. 이 설정으로 편집 요금이 달라지지는 않습니다. |
keep_original_audio | 아니요 | 기본값 true는 원본 사운드를 보존하고 false는 화면에 맞는 새 사운드트랙을 생성합니다. 값을 바꿔도 추가 비용은 없습니다. 기본값: |
요금
$0.151 / 초
편집은 원본 초 수를 정수로 올림해 최대 20초까지 청구합니다. 원본이 5.04초이면 출력이 5.04초로 유지되어도 6초 요금이 적용됩니다. 프롬프트, 레퍼런스 이미지, 화면비, 오디오 선택에는 별도 비용이 없습니다. Kling 심사에서 거부된 요청도 청구 대상에서 제외합니다.
활용 사례
- 천문대 클립의 동작을 유지한 채 에메랄드색 이브닝드레스를 시험합니다.
- 짧은 소셜 장면을 여러 버전으로 나누어 코트 색상을 비교합니다.
- 촬영한 움직임과 원본 사운드트랙을 유지하면서 시각적 초안을 여러 안으로 만듭니다.
프롬프트 가이드 및 실전 팁
- ‘장면과 카메라 움직임 유지’처럼 보존할 요소부터 적어 편집에서 고정할 부분을 정합니다.
- 여러 변형을 요청하기 전에 ‘코트를 차콜 그레이로 변경’처럼 하나의 수정을 구체적으로 지정합니다.
- ‘@Image1의 재킷 사용’처럼 추가한 이미지마다 역할을 붙여 수정 내용과 연결합니다.
- 의상을 편집할 때는 ‘에메랄드색 벨벳 드레스’처럼 소재와 색을 함께 설명합니다.
- 새 사운드트랙이 필요하면 keep_original_audio를 끄고 ‘사운드: 낮은 모터 진동음과 저녁 바람’ 같은 지시를 넣습니다.
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/4.0-flash/video-edit",
"input": {
"aspect_ratio": "auto",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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 레퍼런스에서 확인하세요.
