소개
Kling 3.0 Motion Control은 캐릭터의 선명한 사진 한 장(image_url)과 구동 영상(video_url, 3~30초)을 받아 그 구동 영상의 동작, 표정, 손짓을 캐릭터에게 재생하면서 사진 속 얼굴, 의상, 배경은 유지합니다. 출력은 구동 영상과 정확히 같은 길이로, 직접 정하는 길이가 아니라 그 길이 기준으로 과금됩니다. prompt는 선택 사항이며, 구동 영상이 보여주지 않는 것—배경이나 룩—에 사용하세요.
시작 소재별 Kling 3.0 모드 선택
| 시작 시점에 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면이나 대본 | Kling 3.0 텍스트→영상 |
| 첫 프레임(선택적으로 마지막 프레임까지) | Kling 3.0 이미지→영상 |
| 캐릭터 사진과 구동 영상 | Kling 3.0 Motion Control(현재 모드) |
핵심 기능 및 하이라이트
사진 한 장, 구동 영상 한 편, 같은 퍼포먼스를 두 번
춤, 걸음, 몸짓의 구동 영상 하나를 촬영하거나 라이선스로 확보한 다음, 필요한 만큼 많은 캐릭터 사진에 실행하세요. 저희 테스트에서는 같은 구동 영상의 루틴이 서로 다른 두 캐릭터에게 박자 하나하나 그대로 맞춰 돌아왔고, 각각 본인의 얼굴, 의상, 배경을 유지했습니다.
결과물은 구동 영상 길이와 같습니다
설정할 길이 필드가 없습니다. 출력 길이는 항상 3~30초 사이의 구동 영상 길이와 일치하며 과금도 같은 길이를 따릅니다.
720p 또는 1080p
Motion Control은 4K까지 가지 않습니다. 해상도는 다른 Kling 3.0 엔드포인트와 같은 방식으로 가격을 바꿉니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 아니요 | 선택 사항입니다. 구동 영상이 보여주지 않는 것—배경, 룩, 추가할 것—에만 사용하세요. 2500자 이하 |
negative_prompt | 아니요 | 클립에서 빼고 싶은 요소(사물, 스타일, 움직임)를 최대 2,500자까지 적습니다. 선택 사항이며 가격에는 영향이 없습니다. 2500자 이하 |
image_url | 예 | 움직일 캐릭터입니다. 인물의 선명한 전신 또는 상반신 사진 한 장. |
video_url | 예 | 구동 영상으로 3~30초, 복사할 동작·표정·몸짓입니다. 결과물은 이 영상과 같은 길이이며 그 길이로 과금됩니다. |
resolution | 아니요 | 720p 또는 1080p입니다. 상위 등급일수록 초당 비용이 더 듭니다. |
keep_original_audio | 아니요 | 구동 영상에 원래 있던 소리를 결과물에 남깁니다. 기본으로 켜져 있습니다. 기본값: |
character_orientation | 아니요 | 결과물에서 인물이 향하는 방향입니다. video(기본값)는 구동 영상 속 인물을, image는 사진 속 인물의 방향을 따릅니다. |
shot_type | 아니요 | 샷을 구성하는 방식입니다. customize(기본값)는 입력을 그대로 따르고, intelligent는 모델이 직접 샷을 구성합니다. |
요금
구동 영상(video_url)의 길이(3~30초)를 1초 단위로 올림해 과금되며, 직접 설정하는 길이가 아닙니다. 해상도가 요율을 바꿉니다.
| 사양 | 요금 |
|---|---|
| $0.1008 / 초 |
| $0.1344 / 초 |
활용 사례
하나의 퍼포먼스를 여러 캐릭터에 재사용하기
구동 영상 하나를 안무로 짜거나 라이선스로 확보한 다음, 시리즈의 모든 캐릭터 사진에 적용하세요—춤 루틴, 제품 프레젠터의 몸짓 세트, 반복되는 인사말까지 동작을 매번 다시 촬영하지 않고 적용할 수 있습니다.
정적인 캐릭터 사진에 실제 연출된 움직임 부여하기
말로 움직임을 설명하고 특정 몸짓이 나오길 바라는 대신, Motion Control은 정확한 동작을 구동 영상으로 한 번 보여주고 그대로 정밀하게 적용하게 해줍니다.
퍼포먼스를 새로운 배경으로 옮기기
선택적인 prompt를 사용해 구동 영상 자체의 배경과는 다른 장소에 캐릭터를 배치하세요. 동작 자체는 그대로 유지됩니다.
프롬프트 가이드 및 실전 팁
움직임은 구동 영상에 맡기세요
프롬프트는 움직임을 설명할 필요가 없습니다. 구동 영상이 이미 제공합니다. 방, 의상 디테일, 분위기처럼 영상이 보여주지 않는 것에만 사용하세요.
캐릭터 사진은 선명하고 인물이 하나여야 합니다
조명이 좋고 가려지지 않은, 한 사람의 선명한 전신 또는 상반신 사진이 Motion Control에 가장 정확한 매칭을 줍니다. 캐릭터가 일부 가려졌거나 특이한 각도로 찍힌 사진은 모델이 추측해야 할 부분이 더 많아집니다.
두 입력 모두 충분히 넓은지 확인하세요
캐릭터 사진과 구동 영상 모두 각 변이 대략 720픽셀 이상이어야 합니다. 그보다 작은 구동 영상은 비용을 지불하기 전, 작업이 시작되기 전에 거부됩니다.
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/character-animation",
"input": {
"character_orientation": "video",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "customize",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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 레퍼런스에서 확인하세요.












