소개
Kling 3.0 Turbo 텍스트→영상은 글로 쓴 장면을 720p 또는 1080p, 정수 초 단위로 3~15초 클립으로 바꾸며 사운드가 같은 과정에서 생성됩니다. 이 엔드포인트에는 무음 모드가 없습니다. 프롬프트에 원하는 대사와 배경음을 설명하면 영상과 함께 렌더링됩니다.
시작 소재별 Kling 3.0 Turbo 모드 선택
| 시작 시점에 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면 | Kling 3.0 Turbo 텍스트→영상 |
| 승인된 첫 이미지 | Kling 3.0 Turbo 이미지→영상 |
핵심 기능 및 하이라이트
사운드는 선택이 아니며, 그것이 바로 핵심입니다
이 엔드포인트에서 나오는 모든 클립에는 생성된 사운드트랙이 담깁니다. 따옴표로 쓴 대사는 실제 발화로 렌더링되고, 음악·발소리·교통소음처럼 이름 붙인 배경음은 영상과 섞여 돌아옵니다. 저희 테스트에서는 실행한 모든 클립에서 대사가 프롬프트와 한 글자도 다르지 않았습니다. 오디오를 끄는 필드는 없습니다. 무음 1080p 클립이 필요하다면 Kling 2.5 Turbo를 대신 사용하세요.
컷 전환 필드 없는 하나의 끊김 없는 테이크
이 엔드포인트에는 멀티샷 설정이 없으므로 모든 클립은 하나의 끊기지 않는 테이크로 재생됩니다. 이어 붙이고 싶은 여러 박자 대신 춤, 질주와 점프, 카메라를 향한 회전처럼 처음부터 끝까지 명확한 동작 하나를 쓰세요.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 샷으로 쓰세요. 화면에 누가 있는지, 동작, 카메라 움직임, 그다음 사운드—따옴표 안 대사와 원하는 배경음입니다. 1자 이상 · 2500자 이하 |
aspect_ratio | 아니요 | 16:9, 9:16, 1:1 중 선택합니다. 프롬프트를 쓰기 전에 정해야 그 프레임에 맞춰 피사체를 배치하는 브리프를 쓸 수 있습니다. |
resolution | 아니요 | 720p 또는 1080p입니다. 상위 등급일수록 초당 비용이 더 듭니다. |
duration_seconds | 아니요 | 정수 초 단위로 3~15초 사이입니다. 해상도와 함께 가격을 결정합니다. |
요금
출력 초당 과금됩니다. 해상도와 길이 모두 요율에 영향을 줍니다.
| 사양 | 요금 |
|---|---|
| $0.112 / 초 |
| $0.14 / 초 |
활용 사례
쇼츠와 릴스를 위한 대사 장면
두 사람이 이야기하고, 웃고, 한 마디씩 주고받는 장면이 여기서 잘 작동합니다. 오디오가 나중에 더빙되는 것이 아니라 영상에 맞춰 돌아오기 때문입니다. 저희가 테스트한 주방 장면에서는 대사, 배경 음악, 끓는 냄비 소리가 모두 같은 파일에 담겨 나왔으며, 게시 전에 별도의 오디오 작업이 필요 없었습니다.
사운드가 맞춰진 액션·움직임 클립
파쿠르, 춤, 그 밖의 신체 동작에는 발소리, 충격음, 숨소리가 움직임과 같은 파일에 함께 들어 있어 별도의 폴리 작업이 필요 없습니다.
처음부터 사운드가 필요한 빠른 소셜 클립
오디오가 영상과 같은 과정에서 생성되므로, 이 엔드포인트는 피드나 릴스에 바로 올릴 짧은 클립에 적합합니다. 별도의 사운드 디자인 단계를 기다리면 게시가 늦어지는 상황에서 특히 그렇습니다.
프롬프트 가이드 및 실전 팁
일어나는 순서대로 샷을 쓰세요
프롬프트를 피사체, 동작, 카메라, 그다음 사운드 순서로 구성하세요. 주방 살사 프롬프트가 쓸 만한 템플릿입니다. 누가 춤추고 무엇을 입었는지, 무엇을 하는지(돌기, 카운터에 부딪히기), 카메라(미디엄샷, 부드러운 핸드헬드), 그다음 사운드(음악, 웃음소리, 끓는 냄비 소리)입니다.
사운드를 분위기가 아니라 동작에 맞추세요
일반적인 분위기 트랙 대신 화면 속 무언가로 인해 발생하는 소리—콘크리트 위 발소리, 끓는 냄비, 스쿠터 엔진—의 이름을 붙이세요. 저희 테스트에서는 눈에 보이는 동작에 연결된 소리가 그것을 만들어낼 게 화면에 없는 막연한 배경음보다 영상과 더 일관되게 동기화되어 렌더링됐습니다.
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/3.0-turbo/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"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 레퍼런스에서 확인하세요.











