소개
Kling 2.6 Motion Control은 구동 영상의 동작, 표정, 몸짓을 스틸 사진 속 캐릭터에게 옮깁니다. 인물의 선명한 사진 한 장과 퍼포먼스를 보여주는 3~30초짜리 클립을 주면 구동 영상과 정확히 같은 길이의 무음 영상을 720p 또는 1080p로 돌려줍니다.
시작 소재별 Kling 2.6 모드 선택
| 시작 시점에 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면 | Kling 2.6 텍스트→영상 |
| 승인된 첫 이미지 | Kling 2.6 이미지→영상 |
| 구동 영상과 캐릭터 사진 | Kling 2.6 Motion Control |
핵심 기능 및 하이라이트
구동 영상이 지시하지 않는 모든 것은 캐릭터 본인의 사진이 우선합니다
저희 테스트에서는 한 댄서가 수행한 힙합 루틴이 네이비 스리피스 슈트를 입은 다른 남성에게 매핑됐습니다. 동작은 하나하나 일치했고, 그의 슈트, 로퍼, 얼굴, 그리고 본인 사진 속 콘크리트 로프트가 구동 영상의 단순한 스튜디오 배경 대신 그대로 이어졌습니다.
무음 출력, 길이는 구동 영상이 정합니다
이 엔드포인트에는 오디오 필드가 없어 결과물은 무음으로 렌더링됩니다. 길이 필드도 없는데, 출력이 항상 구동 영상의 길이(3~30초)와 일치하기 때문입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 아니요 | 선택 사항입니다. 구동 영상이 이미 보여주지 않는 것—유지할 배경, 의상의 세부 사항, 고정하고 싶은 것—에만 사용하세요. 2500자 이하 |
image_url | 예 | 움직일 캐릭터입니다. 인물의 선명한 전신 또는 상반신 사진 한 장. |
video_url | 예 | 구동 영상으로 3~30초, 복사할 동작·표정·몸짓입니다. 결과물은 이 영상과 정확히 같은 길이이며 오디오가 없습니다. |
resolution | 아니요 | 720p 또는 1080p입니다. 상위 등급일수록 초당 비용이 더 듭니다. |
요금
구동 영상 길이 기준으로 초당 과금됩니다. 출력은 입력한 영상과 정확히 같은 길이로 나옵니다.
| 사양 | 요금 |
|---|---|
| $0.069 / 초 |
| $0.112 / 초 |
활용 사례
하나의 퍼포먼스를 여러 캐릭터에 재사용하기
구동 영상 하나를 한 번만 촬영하거나 생성한 다음, 매번 처음부터 다시 애니메이션화하지 않고 서로 다른 캐릭터 사진에 적용해 같은 루틴, 걸음, 몸짓을 재캐스팅하세요.
정적인 캐릭터 디자인에 움직임 더하기
움직임이 자유분방하지 않고 의도적으로 보여야 할 때, 이미 디자인했거나 생성한 캐릭터에 기존 퍼포먼스로 생명을 불어넣으세요.
프롬프트 가이드 및 실전 팁
복사할 것이 아니라 유지할 것을 말하세요
구동 영상이 이미 동작, 표정, 몸짓을 담고 있습니다. 프롬프트 필드는 그것이 보여주지 못하는 것—가장 흔하게는 구동 영상 속 배경이 아니라 캐릭터 본인의 방처럼 유지할 배경—을 위한 것입니다.
구동 영상과 사진의 프레이밍을 맞추세요
저희 테스트는 전신 구동 영상을 전신 캐릭터 사진과 짝지었습니다. 둘 사이의 프레이밍이 크게 어긋나는 경우—예를 들어 전신 영상으로 상반신 사진을 구동하는 경우—는 먼저 낮은 해상도로 테스트해볼 가치가 있는 입력입니다.
두 입력 모두 충분히 넓은지 확인하세요
캐릭터 사진과 구동 영상 모두 각 변이 약 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/2.6/character-animation",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"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 레퍼런스에서 확인하세요.
