소개
Kling O3 레퍼런스→영상은 하나의 첫 프레임 대신 최대 7장의 레퍼런스 사진—캐릭터, 의상, 사물, 장소—으로 샷을 구성합니다. 프롬프트에서 레퍼런스에 번호를 매기고(<<<image_1>>>, <<<image_2>>> 등) 각각이 무엇을 담당하는지 말하세요. 프롬프트 필드는 최대 2,500자입니다. 길이는 3~15초 사이 정수 초, 해상도는 최대 4K, 화면비, 네이티브 오디오 생성 여부를 선택할 수 있습니다.
시작 소재별 Kling O3 모드 선택
| 시작 시점에 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면뿐 | Kling O3 텍스트→영상 |
| 승인된 첫 프레임 | Kling O3 이미지→영상 |
| 최대 7장의 레퍼런스 사진 | Kling O3 레퍼런스→영상 |
| 이미 가진 영상 | Kling O3 영상 편집 |
핵심 기능 및 하이라이트
여러 레퍼런스, 하나의 샷
한 프레임에서 시작하는 이미지→영상과 달리, 레퍼런스→영상은 최대 7장의 개별 사진을 받아 각각이 보여주는 것을 결합합니다. 저희 식당차 예시는 남자, 방, 사물 세 가지를 사용했고 셋 중 어느 사진도 단독으로는 보여주지 못한 장면으로 캐스팅되었습니다.
각 레퍼런스는 역할이 하나씩
역할을 지정하는 곳은 프롬프트입니다. "<<<image_1>>>은 남자, 코트와 수염 자국을 유지"라고 쓰면 모델이 다른 레퍼런스와 평균 내는 대신 그 얼굴과 의상을 그대로 유지합니다.
구성된 장면과 함께 생성되는 사운드
generate_audio는 같은 과정에서 배경음, 효과음, 대사를 추가합니다. 한두 문구로만 설명한 배경음에 대한 기대치는 현실적으로 잡으세요. 최종 믹스에서 조용하게 렌더링될 수 있고, 두드러지는 레이어는 아닙니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 번호가 매겨진 각 레퍼런스가 무엇인지(<<< |
reference_image_urls | 예 | 캐릭터, 사물, 의상, 장소를 위한 레퍼런스 사진 최대 7장입니다. JPEG 또는 PNG. 1개 이상 · 7개 이하 |
reference_video_urls | 아니요 | 선택 사항인 참고 영상(1개)으로, 새 샷이 그 움직임, 카메라 워크, 인물을 참고합니다. 프롬프트에서는 <<< |
elements | 아니요 | 4K 실행용 이름 붙은 피사체를 하나 지정합니다. 이름, 한 줄 설명, 같은 인물이나 사물의 사진 2 |
aspect_ratio | 아니요 | 16:9, 9:16, 1:1 중 선택합니다. 구도에 맞도록 샷을 쓰기 전에 먼저 정하세요. |
resolution | 아니요 | 720p, 1080p, 4K 중 선택합니다. 상위 등급일수록 초당 비용이 더 듭니다. |
generate_audio | 아니요 | 같은 과정에서 따옴표로 쓴 대사, 효과음, 배경음이 담긴 사운드트랙을 생성합니다. 720p와 1080p에서는 무음보다 초당 비용이 더 들지만, 4K에서는 음성을 켜든 끄든 가격이 같습니다. 기본값: |
keep_original_audio | 아니요 | 참고 영상에 원래 있던 소리를 결과물에 남깁니다. 기본으로 켜져 있으며 참고 영상을 넣었을 때만 의미가 있습니다. 기본값: |
duration_seconds | 아니요 | 정수 초 단위로 3~15초 사이입니다. 해상도, 오디오와 함께 가격을 결정합니다. |
shot_type | 아니요 | single은 한 테이크로 이어지는 촬영을 요청합니다(완전히 보장되지는 않습니다). multi는 모델이 알아서 여러 샷으로 나눕니다. |
multi_prompt | 아니요 | shot_type이 customize일 때 쓰는 샷 목록입니다. 최대 6개 샷을 순서대로 넣고 각 샷에 프롬프트(최대 512자)와 정수 초 길이를 지정합니다. 1개 이상 · 6개 이하 |
요금
출력 초당 과금됩니다. 요율은 해상도, 네이티브 오디오 사용 여부, 참고 영상 사용 여부에 따라 달라집니다.
| 사양 | 요금 |
|---|---|
| $0.0672 / 초 |
| $0.0896 / 초 |
| $0.419 / 초 |
| $0.0896 / 초 |
| $0.112 / 초 |
| $0.419 / 초 |
| $0.1008 / 초 |
| $0.1344 / 초 |
활용 사례
한 번도 촬영되지 않은 장소에 인물 배치하기
얼굴에는 별도 레퍼런스를, 장소에는 별도 레퍼런스를 주고 둘을 함께 놓는 동작을 설명하세요. 어느 한쪽 사진만으로는 만들 수 없는 종류의 샷입니다.
여러 샷에서 소품이나 의상을 일관되게 유지하기
특정 사물—장신구, 자동차, 시그니처 의상—을 캐릭터 레퍼런스와 함께 지정하면, 실행할 때마다 조금씩 다르게 다시 그려지는 대신 정확히 다시 등장합니다.
세 가지 계획된 요소로 장면 구성하기
특정 인물, 특정 배경, 특정 사물—편지, 방, 그것을 읽는 사람처럼—이 모두 함께 등장해야 하는 샷이라면, 산문으로 처음부터 설명하는 대신 레퍼런스로 셋 모두를 고정할 수 있습니다.
프롬프트 가이드 및 실전 팁
모든 레퍼런스에 번호를 매기고 역할을 지정하세요
각 레퍼런스마다 순서대로 "<<<image_1>>>은 X, Y를 유지"라고 쓰세요. 레퍼런스가 깔끔하게 이어질지, 아니면 다른 것과 섞여버릴지를 가르는 가장 큰 요인입니다.
겹치는 사진 일곱 장보다 명확한 사진 서너 장을 쓰세요
레퍼런스가 많다고 자동으로 좋아지지 않습니다. 얼굴 한 장, 의상 한 장, 방 한 장처럼 명확하고 구분되는 사진 몇 장이, 보여주는 내용이 겹치는 사진 일곱 장보다 정체성을 더 잘 유지합니다.
사운드는 배경 레이어로 설명하세요
대사와 함께 빗소리나 기차 바퀴 소리 같은 배경음을 요청하면 믹스에서 낮게 깔릴 것으로 예상하세요. 배경음이 두드러져야 한다면, 대사 옆에 간단히 나열하는 대신 명시적으로 그렇게 말하세요.
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/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"generate_audio": false,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "720p",
"shot_type": "single"
}
}'
# 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 레퍼런스에서 확인하세요.












