소개
Kling 4.0 Flash 레퍼런스→영상은 필수 프롬프트와 제공한 레퍼런스로 새로운 720p 장면을 생성합니다. 이미지는 최대 10장, 영상 클립은 최대 5개에 합계 20초까지 넣습니다. 업로드한 순서에 따라 이미지에는 @Image1, 영상에는 @Video1부터 번호를 붙입니다.
각 레퍼런스를 어떻게 활용할지 프롬프트로 설명합니다. 사막 예시에서는 이미지 1장으로 피사체를 정하고 영상 2개로 황혼 장면의 카메라 움직임을 안내합니다. 새 클립은 3~20초 사이의 정수 길이로 생성되며 기본값은 5초이고 동기화된 오디오가 포함됩니다. keep_original_audio를 사용하면 레퍼런스 영상의 사운드를 유지할 수 있습니다. 오디오 파일 레퍼런스는 지원 대상이 아닙니다.
핵심 기능 및 하이라이트
- 프롬프트에서 최대 10장의 레퍼런스 이미지를 피사체, 사물, 장면 세부 요소에 할당합니다.
- 합계 20초 이내의 영상 최대 5개로 움직임과 구도를 안내합니다.
- @Image1과 @Video1 표기로 장면 설명과 제공한 파일을 연결합니다.
- 오디오가 담긴 3~20초 720p 결과를 생성하거나 keep_original_audio로 레퍼런스 영상의 소리를 유지합니다.
- auto로 입력 구도를 따르거나 16:9, 9:16, 1:1, 21:9를 선택합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 장면 지시가 필수이며 기본 텍스트는 없습니다. @Image1, @Image2, @Video1과 이후 업로드 파일의 역할을 정합니다. 1자 이상 |
reference_image_urls | 아니요 | 이미지 URL을 최대 10개 제공하고 업로드 순서에 따라 @Image1, @Image2 등으로 표시합니다. 장면의 기준이 되며 가격에는 영향을 주지 않습니다. 1개 이상 · 10개 이하 |
reference_video_urls | 아니요 | 영상 URL은 최대 5개, 전체 길이는 20초까지 제공하며 @Video1, @Video2 등으로 표시합니다. 영상 레퍼런스를 추가하면 출력 초당 요금이 올라가고 레퍼런스 자체의 초 수는 별도로 청구하지 않습니다. 1개 이상 · 5개 이하 |
aspect_ratio | 아니요 | auto로 레퍼런스 구도를 따르거나 16:9, 9:16, 1:1, 21:9를 선택합니다. 화면비로 초당 요금이 달라지거나 추가 비용이 발생하지 않습니다. |
keep_original_audio | 아니요 | true이면 레퍼런스 영상의 소리를 유지하고 false이면 사운드트랙을 새로 생성합니다. 레퍼런스 영상을 제공했을 때 적용되며 오디오 선택으로 가격은 달라지지 않습니다. 기본값: |
duration_seconds | 아니요 | 출력 길이는 3~20초 사이의 정수로 받으며 기본 길이는 5초입니다. 청구 기준인 출력 길이가 달라지면 총요금도 달라집니다. |
요금
$0.113 / 초
레퍼런스 기반 생성은 출력 초 수에 따라 계산합니다. 레퍼런스 영상을 넣으면 출력 길이에 더 높은 초당 요금이 적용되며 레퍼런스 영상의 길이는 별도로 청구하지 않습니다. 이미지 레퍼런스, 프롬프트 문구, 화면비, keep_original_audio에는 추가 비용이 없습니다. Kling 심사에서 거부한 요청에는 요금이 발생하지 않습니다.
활용 사례
- 이미지 속 피사체를 짧은 동작 클립으로 안내하는 사막 소셜 장면에 배치합니다.
- 이미지 레퍼런스마다 이름을 따로 붙여 인물과 장소의 조합을 시험합니다.
- 선택한 카메라 움직임을 중심으로 짧은 장면 초안을 여러 개 만들어 콘텐츠를 검토합니다.
프롬프트 가이드 및 실전 팁
- 새 장면을 설명하기 전에 ‘@Image1은 피사체의 기준’처럼 이미지별 역할을 정합니다.
- ‘@Video1의 느린 카메라 접근을 활용’처럼 영상에서 가져올 요소를 설명해 용도를 명확히 합니다.
- ‘황혼의 고요한 사막’처럼 새로운 배경을 묘사해 만들 장면과 레퍼런스 소재를 구분합니다.
- 3초 초안에서는 ‘표지판 옆에 멈추는 여행자’처럼 짧고 간결한 동작을 요청합니다.
- 사운드트랙을 새로 생성할 때는 ‘사운드: 메마른 바람과 멀리서 들리는 기차’ 같은 단서로 오디오를 안내합니다.
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/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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 레퍼런스에서 확인하세요.
