소개
Kling 2.6 텍스트→영상은 글로 쓴 장면을 고정 1080p, 5초 또는 10초 클립으로 바꿉니다. 설정할 해상도 필드가 없으며 출력은 항상 1080p입니다. generate_audio는 선택 사항으로, 꺼두면 무음 렌더링이 되고 켜면 대사, 음악, 배경음이 영상과 함께 생성됩니다.
시작 소재별 Kling 2.6 모드 선택
| 시작 시점에 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면 | Kling 2.6 텍스트→영상 |
| 승인된 첫 이미지 | Kling 2.6 이미지→영상 |
| 구동 영상과 캐릭터 사진 | Kling 2.6 Motion Control |
핵심 기능 및 하이라이트
사운드는 선택이며 영상과 함께 렌더링됩니다
generate_audio를 켜면 따옴표로 쓴 대사와 이름 붙인 배경음이 영상과 같은 파일로 돌아옵니다. 저희 다이너 테스트에서는 겹쳐지는 웃음소리, 도돕 음악을 트는 주크박스, 부딪히는 식기 소리 모두 장면과 동기화되어 도착했지만, 그룹의 손짓은 프롬프트가 요청한 것보다 조금 더 절제되어 나왔습니다.
고정 1080p, 선택할 등급 없음
이 엔드포인트에는 해상도 필드가 없으며 모든 클립이 1080p로 렌더링됩니다. 길이도 5초 또는 10초로 고정되어 있고 그 사이 값을 위한 필드는 없습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 샷으로 쓰세요. 화면에 누가 있는지, 동작, 카메라 움직임, 그리고 사운드를 켰다면 따옴표 안 대사와 원하는 배경음입니다. 1자 이상 · 2500자 이하 |
negative_prompt | 아니요 | 나오면 안 되는 것을 적습니다. 두 번째 인물, 자막, 모델이 자꾸 끌어오는 소품 같은 것들입니다. 2500자 이하 |
aspect_ratio | 아니요 | 16:9, 9:16, 1:1 중 선택합니다. 프롬프트를 쓰기 전에 정해야 그 프레임에 맞춰 피사체를 배치하는 브리프를 쓸 수 있습니다. |
generate_audio | 아니요 | 기본적으로 꺼져 있습니다. 켜면 대사, 음악, 배경음이 담긴 사운드트랙이 영상과 함께 생성되며 초당 비용이 더 듭니다. 기본값: |
duration_seconds | 아니요 | 5초 또는 10초만 가능하며 다른 값은 받지 않습니다. 가격을 결정합니다. |
guidance_scale | 아니요 | 클립이 프롬프트를 얼마나 엄격하게 따를지를 0에서 1까지 0.01 단위로 정합니다. 기본값은 0.5입니다. |
요금
출력 초당 과금됩니다. 사운드를 켜면 초당 비용이 더 듭니다.
| 사양 | 요금 |
|---|---|
| $0.069 / 초 |
| $0.138 / 초 |
활용 사례
대사 중심 그룹 장면
한 공간에서 몇 사람이 이야기하고 반응하는 장면이 여기서 잘 작동하며, 룸 톤과 대사가 영상과 같은 과정에서 렌더링됩니다.
Motion Control 구동 영상으로 재사용할 깔끔한 테이크
단순한 배경과 고정 카메라 앞에서 전신이 프레임에 담긴 퍼포머 한 명은 다른 캐릭터를 위한 Motion Control(character-animation)의 구동 영상으로 바로 넣을 수 있는 테이크를 만듭니다.
프롬프트 가이드 및 실전 팁
장면을 쓰기 전에 사운드부터 결정하세요
generate_audio를 끄기로 했다면 영상만 설명하세요. 켜기로 했다면 프롬프트 끝에 따옴표 안 대사와 원하는 배경음을 넣으세요. 저희 테스트에서는 그것들이 위에 얹힌 일반적인 레이어가 아니라 눈에 보이는 동작에 연결되어 렌더링됐습니다.
구동 영상을 원한다면 전신 외에는 요구하지 마세요
단순한 배경, 고정 카메라, 전신을 계속 프레임에 담으라는 지시가 Motion Control에 쓰기 가장 깔끔한 소스를 만듭니다. studio-dancer-take 예시가 정확히 이 방식으로 만들어졌고, 다른 Kling 계열의 구동 영상으로 두 번 재사용했습니다.
장면을 쓰기 전에 5초 또는 10초를 정하세요
길이는 두 값 중 하나만 가능하므로 장면을 쓰기 전에 길이를 정하세요. 짧은 반응이 붙은 대사 한 줄은 5초 안에 여유롭게 들어갑니다. 여러 박자가 있는 대화나, 도착하기 전에 잠깐의 정적이 필요한 대사는 서두른 느낌이 나지 않도록 10초를 온전히 써야 합니다.
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/2.6/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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 레퍼런스에서 확인하세요.
