소개
Kling O3 텍스트→영상은 이미지나 레퍼런스 없이 글로 쓴 프롬프트만으로 3~15초 클립을 만듭니다. 길이는 정수 초 단위로, 해상도는 720p부터 4K까지 선택할 수 있고, 영상과 함께 네이티브 오디오를 생성할지도 정할 수 있습니다. 프롬프트 필드는 최대 2,500자로, 피사체와 동작, 카메라, 사운드를 켠 경우 대사까지 담기에 충분합니다.
시작 소재별 Kling O3 모드 선택
| 시작 시점에 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면뿐 | Kling O3 텍스트→영상 |
| 승인된 첫 프레임 | Kling O3 이미지→영상 |
| 최대 7장의 레퍼런스 사진 | Kling O3 레퍼런스→영상 |
| 이미 가진 영상 | Kling O3 영상 편집 |
핵심 기능 및 하이라이트
알아서 나누는 멀티샷 컷
shot_type을 multi로 설정하고 프롬프트에 와이드샷, 클로즈업, 로우앵글처럼 두 개 이상의 샷을 설명하면 Kling O3가 한 클립 안에서 컷을 나누면서도 배경과 인물을 샷마다 일관되게 유지합니다. 저희 빗속 탱고 예시는 세 개의 샷을 순서대로 설명한 프롬프트 하나였고, 완성된 클립은 각 컷에 정확히 맞춰 전환되었습니다.
같은 과정에서 생성되는 네이티브 오디오
generate_audio를 켜면 대사, 효과음, 배경음이 나중에 추가되는 것이 아니라 영상과 함께 생성됩니다. 따옴표로 쓴 대사는 동작에 맞춰 돌아옵니다. 저희 재즈 클럽 예시에서는 두 줄 모두 프롬프트와 한 글자도 다르지 않게 일치했습니다.
720p부터 4K까지, 프롬프트는 하나
세 해상도 모두 같은 프롬프트로 렌더링되므로, 보통은 샷과 대사가 잘 나올 때까지 720p로 초안을 잡은 다음 최종본을 1080p나 4K로 다시 실행합니다. 해상도와 오디오 모두 가격에 영향을 줍니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 피사체, 동작, 카메라, 그리고 사운드를 켠 경우 대사와 소리까지 설명하세요. 멀티샷 프롬프트라면 샷에 순서대로 번호를 매기세요. 1자 이상 · 2500자 이하 |
aspect_ratio | 아니요 | 16:9, 9:16, 1:1 중 선택합니다. 샷을 쓰기 전에 먼저 정해야 그 비율에 맞춰 인물과 프레이밍을 배치하는 프롬프트를 쓸 수 있습니다. |
resolution | 아니요 | 720p, 1080p, 4K 중 선택합니다. 상위 등급일수록 초당 비용이 더 듭니다. |
generate_audio | 아니요 | 따옴표로 쓴 대사, 효과음, 배경음이 담긴 사운드트랙을 같은 과정에서 함께 생성합니다. 720p와 1080p에서는 무음보다 초당 비용이 더 들지만, 4K에서는 음성을 켜든 끄든 가격이 같습니다. 기본값: |
duration_seconds | 아니요 | 정수 초 단위로 3~15초 사이입니다. 해상도, 오디오와 함께 가격을 결정합니다. |
shot_type | 아니요 | single은 한 테이크로 이어지는 촬영을 요청합니다(완전히 보장되지는 않으니, 그래도 컷이 나타나면 프롬프트에 "one continuous shot, no cuts"를 추가하세요). multi는 모델이 프롬프트를 알아서 여러 샷으로 나누게 합니다. |
multi_prompt | 아니요 | shot_type이 customize일 때 쓰는 샷 목록입니다. 최대 6개 샷을 순서대로 넣고 각 샷에 프롬프트(최대 512자)와 정수 초 길이를 지정합니다. 1개 이상 · 6개 이하 |
요금
출력 초당 과금됩니다. 요율은 해상도와 네이티브 오디오 사용 여부에 따라 달라집니다.
| 해상도 | 오디오 생성: 아니요 | 오디오 생성: 예 |
|---|---|---|
| $0.0672 / 초 | $0.0896 / 초 |
| $0.0896 / 초 | $0.112 / 초 |
| $0.336 / 초 | $0.336 / 초 |
활용 사례
손에 이미지가 없는 장면 열기
텍스트→영상은 글만으로 충분한 유일한 Kling O3 모드입니다. 샷이 머릿속에만 존재할 때, 또는 첫 프레임을 이미지→영상에 넘기기 전에 어떤 프레이밍이 맞는지 빠르게 여러 테이크로 확인해야 할 때 사용하세요.
요청 한 번으로 여러 각도의 장면 커버하기
네 개의 각도마다 따로 프롬프트를 쓰는 대신, 시퀀스를 한 번만 설명하고 shot_type을 multi로 설정하세요. 작업 한 번으로 와이드샷, 클로즈업, 리액션 샷을 얻는 가장 빠른 방법입니다.
긴 편집 전에 대사 타이밍 미리 확인하기
오디오가 영상과 함께 렌더링되기 때문에, 더 길거나 더 높은 해상도로 실행하기 전에 짧은 텍스트→영상 초안으로 대사 한 줄이 동작과 자연스럽게 어울리는지 빠르게 확인할 수 있습니다.
프롬프트 가이드 및 실전 팁
컷을 원한다면 샷마다 번호를 매기세요
멀티샷 프롬프트라면 저희 탱고 예시처럼 원하는 순서대로 샷을 나열하고 각각의 카메라—와이드, 클로즈업, 로우앵글—를 설명하세요. Kling O3는 이 구조를 보고 어디서 컷을 나눌지 판단합니다.
분위기가 아니라 카메라 위치를 지정하세요
"건반 끝에서 바라봐서 두 얼굴이 모두 보이게"는 모델이 실제로 따를 수 있는 지시입니다. "피아노 벤치에 앉은 두 남자"라고만 쓰면 각도가 운에 맡겨지고, 그 결과 한 인물이 다른 인물 뒤에 가려질 수 있습니다. 두 명 이상이 계속 보여야 한다면 피사체 대비 카메라 위치를 명시하세요.
고정 샷은 명확히 요청하세요
single은 선호일 뿐 보장이 아니며, Kling O3는 여전히 알아서 컷을 나눌 수 있습니다. 한 장면이 끊김 없는 한 테이크에 의존한다면 프롬프트 끝에 "one continuous shot, no cuts, the light staying the same throughout" 같은 문장을 추가하세요.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"shot_type": "single",
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": false,
"duration_seconds": 5
}
}'
# 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 레퍼런스에서 확인하세요.












