소개
Kling 2.1 Master 이미지→영상은 첫 프레임을 오디오 트랙 없는 1080p, 5초 또는 10초 클립으로 애니메이션화하며, 이 엔드포인트에는 마지막 프레임 옵션이 없습니다—image_url만 있습니다.
시작 소재별 Kling 2.1 Master 모드 선택
| 시작 시점에 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면 | Kling 2.1 Master 텍스트→영상 |
| 승인된 첫 프레임 | Kling 2.1 Master 이미지→영상 |
핵심 기능 및 하이라이트
프레임은 유지되고 프롬프트가 움직임을 제공합니다
첫 프레임의 의상, 포즈, 조명, 배경은 보낸 그대로 정확히 유지됩니다. 프롬프트는 그다음에 일어나는 일과 카메라가 어디로 가는지만 설명하면 됩니다. 저희 테스트에서는 얼어붙은 파도와 물속 무도회 드레스 모두 구도와 의상을 그대로 유지한 채, 정지 이미지 한 장에서 설득력 있게 살아났습니다.
이 엔드포인트에는 마지막 프레임이 없습니다
Kling 2.1의 표준 이미지→영상과 달리 Master의 이미지→영상은 image_url만 받고 last_image_url은 받지 않습니다. 특정 결말 포즈가 중요하다면, 두 번째 프레임이 그것을 고정해줄 거라 기대하는 대신 프롬프트 자체에서 결말을 설명해 모델이 그쪽으로 향하게 하세요.
세로 프레임에서는 얼굴이 더 작게 나올 수 있습니다
첫 프레임이 세로 크롭이면 렌더링도 그 형식을 따라가며, 저희 테스트 중 하나에서는 가로 프레임보다 얼굴이 더 작고 약간 덜 선명하게 나왔습니다. 세로 첫 프레임에서 얼굴을 더 타이트하게 크롭하면 완성된 클립에 더 많은 디테일이 남습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 첫 프레임 이후에 일어나는 일—동작과 카메라 움직임—만 설명하세요. 1자 이상 · 5000자 이하 |
image_url | 예 | 첫 프레임입니다. JPEG 또는 PNG만 가능합니다. |
duration_seconds | 아니요 | 정수 초로 5초 또는 10초입니다. 가격을 결정합니다. |
negative_prompt | 아니요 | 클립이 피해야 할 것들의 짧은 목록입니다. 복잡한 카메라 움직임에서 흔한 렌더링 결함을 피하는 데 유용합니다. 500자 이하 |
guidance_scale | 아니요 | 0~1입니다. 높을수록 문구에 더 가깝게, 낮을수록 모델에게 더 많은 자유를 줍니다. |
요금
$0.216 / 초
출력 클립의 초당 과금됩니다. Kling이 거부한 업로드는 과금되지 않습니다.
활용 사례
특정 스틸을 최고 품질의 움직임으로 만들기
첫 프레임이 이미 정확히 원하는 대로이고(조명, 의상, 포즈) 렌더링이 다른 저렴한 테이크와 비교할 초안이 아니라 최종본이어야 할 때 이 등급을 사용하세요.
분위기 있는 움직임: 원단, 물, 불, 먼지
흐르는 가운, 말려드는 파도, 흩날리는 안개, 흔들리는 샹들리에가 저희 테스트에서 스틸 프레임과 움직임을 설명하는 프롬프트만으로 자연스럽게 렌더링됐습니다. 대사나 빠른 액션보다 분위기 중심의 장면에 잘 맞습니다.
같은 프로젝트 안의 또 다른 고품질 클립
이 엔드포인트는 Text to video와 Master의 더 높은 가격을 공유하므로 같은 방식으로 다루세요. 다른 곳에서 이미 승인받은 장면을 위해 아껴두고, 문구는 먼저 더 저렴한 등급에서 다듬으세요.
프롬프트 가이드 및 실전 팁
스틸 프레임의 요소에게 언제 움직일지 말하세요
전체 장면을 다시 설명하는 대신, 이미 프레임 안에 있는 것(파도, 포즈, 의상)을 가리키고 그것이 살아나야 할 순서를 설명하세요. 모델은 이미지가 어떻게 생겼는지 이미 알고 있습니다.
선회하거나 표류하는 카메라에는 negative_prompt를 짝지으세요
예를 들어 흐릿한 얼굴이나 일그러진 손을 지목하는 짧은 negative_prompt는 느린 선회나 수중 느낌의 표류 움직임을 이 모델에서 더 흔한 렌더링 결함으로부터 저렴하게 벗어나게 합니다. 클립이 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.1-master/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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 레퍼런스에서 확인하세요.
