소개
Kling 4.0 레퍼런스→영상은 업로드한 소재로 새 클립을 만듭니다. 사람, 사물, 장소를 위한 레퍼런스 이미지를 최대 10장, 카메라와 피사체의 움직임과 리듬을 위한 레퍼런스 영상을 최대 5개(총 30초), 목소리나 소리를 위한 오디오 클립을 최대 3개 받습니다. 각 소재는 프롬프트에서 업로드 순서대로 @Image1, @Image2, @Video1, @Audio1처럼 이름을 붙이십시오. 클립은 3~30초, 720p 또는 1080p, 스테레오 사운드트랙과 함께 나옵니다.
시작 소재에 따라 Kling 4.0 모드 고르기
| 시작할 때 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면이나 대본 | Kling 4.0 텍스트→영상 |
| 첫 프레임, 그리고 선택적으로 마지막 프레임과 중간 프레임 | Kling 4.0 이미지→영상 |
| 소재로 쓸 사진, 클립 또는 음성 샘플 | Kling 4.0 레퍼런스→영상 (현재 보고 계신 곳) |
핵심 기능 및 하이라이트
이미지, 영상, 목소리를 한 요청에
Kling 4.0은 세 종류의 레퍼런스를 함께 받습니다. 이미지는 누가 어떤 모습으로 나올지를, 영상은 카메라와 피사체가 어떻게 움직일지를, 오디오 클립은 누가 어떤 목소리로 말하는지를 정합니다.
프롬프트에서 레퍼런스에 이름 붙이기
@Image1, @Image2 등을 업로드 순서대로 쓰고 각각이 무엇인지 적으십시오. 저희 트레일러 예시에서 ‘@Image1 is the woman, @Image2 is the chrome trailer’라는 문장만으로 그 여성을 그 트레일러 앞에 세우기에 충분했습니다.
클립에서 카메라 움직임 빌리기
레퍼런스 영상은 움직임과 리듬을 넘겨줍니다. keep_original_audio를 켜면 새 오디오를 생성하는 대신 그 클립의 원래 사운드를 유지합니다. 레퍼런스 영상의 초는 출력 초보다 낮은 요금으로 따로 청구됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 각 레퍼런스가 무엇인지, 그리고 샷이 그것으로 무엇을 하는지 적으십시오. 이미지는 @Image1, @Image2, 영상은 @Video1, 오디오 클립은 @Audio1처럼 업로드 순서대로 번호를 붙이십시오. 1자 이상 |
reference_image_urls | 아니요 | 사람, 사물, 의상 또는 장소를 담은 이미지 최대 10장이며 @Image1, @Image2 등으로 지칭합니다. 가격은 바뀌지 않습니다. 1개 이상 · 10개 이하 |
reference_video_urls | 아니요 | 움직임, 카메라, 리듬을 위한 영상 최대 5개, 합계 30초이며 @Video1, @Video2로 지칭합니다. 각 클립의 초는 1초 단위로 올림되어, 출력 초보다 낮은 요금으로 청구됩니다. 1개 이상 · 5개 이하 |
reference_audio_urls | 아니요 | 목소리나 소리를 위한 오디오 클립 최대 3개, 각 5~30초이며 @Audio1, @Audio2로 지칭합니다. 대사는 프롬프트에 적으십시오. 1개 이상 · 3개 이하 |
aspect_ratio | 아니요 | auto(기본값)는 레퍼런스 이미지나 영상을 따릅니다. 16:9, 9:16, 1:1 또는 21:9로 직접 정할 수 있습니다. |
resolution | 아니요 | 720p 또는 1080p(기본값 720p). 1080p는 초당 요금이 더 높습니다. |
keep_original_audio | 아니요 | 기본값은 꺼짐입니다. 켜면 새 사운드트랙을 생성하지 않고 레퍼런스 영상 자체의 사운드를 유지합니다. 기본값: |
duration_seconds | 아니요 | 정수 3~30초(기본값 5). 가격을 결정합니다. |
요금
출력 초 단위로 요금이 부과되며, 레퍼런스 영상의 초(각 클립은 1초 단위로 올림)는 더 낮은 초당 요금으로 추가됩니다. 1080p는 720p보다 초당 요금이 높습니다. 레퍼런스 이미지와 오디오 클립은 가격을 바꾸지 않습니다. 거부되거나 실패한 요청에는 요금이 부과되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.216 / 초 |
| $0.324 / 초 |
활용 사례
촬영한 적 없는 장소에 인물 넣기
인물 사진과 장소 사진을 함께 쓰면 그 인물이 그 장소에 있는 장면을, 원하는 동작과 함께 만들 수 있습니다.
소품이나 차량 일관성 유지
자동차, 오토바이, 의상에 각각 레퍼런스 이미지를 주면 모든 클립에서 같은 모습을 유지합니다.
목소리 맞추기
5~30초 음성 샘플을 @Audio1로 추가하고 대사를 따옴표에 넣으면, 말하는 대사가 그 목소리를 따릅니다.
프롬프트 가이드 및 실전 팁
출연진 목록으로 시작하기
레퍼런스마다 한 문장씩으로 시작하십시오. 예: ‘@Image1 is the man, @Image2 is the motorcycle’. 그다음 샷을 묘사하십시오.
비슷한 레퍼런스 여러 장보다 분명한 몇 장
인물이나 사물 한 명당 선명한 사진 한 장이, 모델이 평균을 내야 하는 비슷한 사진 여러 장보다 낫습니다.
aspect_ratio는 자동으로 두기
자동 설정이면 클립이 레퍼런스의 모양을 따릅니다. 특정 프레임이 필요할 때만 지정하십시오.
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/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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 레퍼런스에서 확인하세요.










