사용 가이드
Kling 3.0 모션 컨트롤 프롬프트 레시피: 바로 복사할 수 있는 프롬프트와 실제 출력
모션은 프롬프트가 아니라 참조 영상에서 나옵니다. 아래는 실제 API 요청 페이로드와 실제 출력 클립을 포함한 실제 레시피입니다.
비디오 모델을 다룬 대부분의 "프롬프트 레시피" 글은 문장 하나를 입력하면 모델이 스스로 모션을 만들어 낸다고 가정합니다. Kling 3.0 모션 컨트롤은 그렇지 않습니다. 이런 기대를 갖고 사용하면 첫 API 호출에서 곧바로 400이 반환됩니다. 이 모델은 두 개의 필수 입력—캐릭터 이미지 한 장과 3~30초 길이의 모션 참조 영상—을 요구하며, 참조 영상의 모션과 표정을 여러분의 캐릭터에 이식합니다. 텍스트 prompt 필드는 선택 사항이며, 스타일, 조명, 장면만 미세 조정합니다. 모션을 설명하지는 않습니다.
따라서 진짜 "레시피"는 문장 하나가 아니라 하나의 조합입니다. 어떤 캐릭터 이미지를 쓰는가 + 어떤 참조 클립을 쓰는가 + 선택적 프롬프트를 어떻게 쓰는가. 아래 두 레시피는 동일한 캐릭터와 동일한 참조 클립을 사용하며, 유일한 변수는 스타일 프롬프트를 첨부할지 여부입니다. 여기의 모든 클립은 hiapi API를 통해 실행된 실제 kling-3.0/motion-control 작업 결과이며, 시뮬레이션 이미지가 아닙니다.
Kling 3.0 모션 컨트롤이 실제로 필요로 하는 것
| 필드 | 필수 | 역할 |
|---|---|---|
image_url |
예 | 모션을 수행하는 캐릭터 |
video_url |
예 | 모션 + 얼굴 표정을 제공하는 3~30초 클립 |
prompt |
아니오 | 스타일/장면/조명만 제어—모션은 제어하지 않음 |
resolution |
아니오 | 720p 또는 1080p |
과금은 출력 초 수를 기준으로 하며 해상도에 따라 구간이 나뉩니다:
- 720p — 초당 $0.10
- 1080p — 초당 $0.172
따라서 6초짜리 720p 클립은 $0.60입니다. 바로 아래 각 레시피의 비용이 이 금액입니다. 전체 가격표: hiapi.ai/pricing.
1단계—캐릭터 이미지 준비
gpt-image-2로 간단한 스튜디오 조명 인물 사진을 생성했습니다(장당 $0.03, 1024×1024):

선명하고 정면을 향한 캐릭터 이미지라면 무엇이든 괜찮습니다—일러스트든 사실적 표현이든 상관없습니다. 이것이 "누구"에 해당합니다.
2단계—모션 참조 클립 준비
사람들이 흔히 건너뛰는 단계이지만, 실은 출력을 진짜로 제어하는 단계입니다. 원하는 모션을 보여 주는 클립이 아직 없다면 생성하면 됩니다. grok-imagine/text-to-video(480p 기준 초당 $0.015)를 사용해 순수 텍스트 프롬프트만으로 6초 참조 클립을 생성했습니다:
{
"model": "grok-imagine/text-to-video",
"input": {
"prompt": "A person turns their head to look over their shoulder, raises one hand in a small wave, then smiles directly at the camera. Medium shot, static frame, soft daylight.",
"duration": "6",
"resolution": "480p"
}
}
비용: 6초 × $0.015 = $0.09. 이 클립은 이제 재사용할 수 있습니다—어떤 캐릭터 이미지에도 적용할 수 있습니다.
레시피 A—기준 이식, 스타일 프롬프트 없음
캐릭터 이미지와 참조 클립을 그대로 입력하고 prompt는 전혀 사용하지 않습니다:
{
"model": "kling-3.0/motion-control",
"input": {
"image_url": "https://static.hiapi.ai/blog/kling-3-0-motion-control-prompts/character-source.png",
"video_url": "https://static.hiapi.ai/blog/kling-3-0-motion-control-prompts/motion-reference.mp4",
"resolution": "720p"
}
}
캐릭터는 참조 클립의 타이밍에 맞춰 정확히 몸을 돌리고, 손을 흔들고, 미소 짓습니다—조명과 구도는 소스 인물 사진과 일치합니다. 비용: 6초 × 초당 $0.10(720p) = $0.60.
레시피 B—동일한 모션, 스타일 유도 프롬프트 추가
image_url과 video_url은 완전히 동일합니다. 유일한 차이는 다른 장면과 조명을 설명하는 prompt를 추가한 것이며, 모션 자체는 여전히 참조 클립에 고정되어 있습니다:
{
"model": "kling-3.0/motion-control",
"input": {
"image_url": "https://static.hiapi.ai/blog/kling-3-0-motion-control-prompts/character-source.png",
"video_url": "https://static.hiapi.ai/blog/kling-3-0-motion-control-prompts/motion-reference.mp4",
"prompt": "Golden-hour outdoor lighting, warm rim light from the left, shallow depth of field with a softly blurred park background.",
"resolution": "720p"
}
}
같은 돌기-손흔들기-미소 짓기 시퀀스, 같은 타이밍—그러나 조명, 색 보정, 배경은 프롬프트에 따라 달라졌습니다. 비용: 추가 $0.60.
진짜 핵심
레시피 A와 레시피 B가 "서로 다른 두 프롬프트가 서로 다른 두 영상을 만들었다"처럼 보인다면, 그것은 잘못된 심상 모델입니다. 두 클립의 모션은 동일합니다. 참조 영상이 동일하기 때문입니다. 프롬프트는 장면 장식만 바꿉니다. 다른 모션을 얻으려면—돌기 대신 손흔들기, 손흔들기 대신 걷기—프롬프트의 표현을 바꾸는 것이 아니라 참조 영상을 교체해야 합니다. 작은 재사용 가능 참조 클립 라이브러리를 구축하고(직접 보유한 라이선스素材 또는 위 2단계처럼 생성한 클립) 원하는 수의 캐릭터 이미지에 재사용하세요. 이것이 모션 컨트롤 출력을 확장하는 진짜 지렛대입니다.
프롬프트가 실제로 모션을 주도하는 순수 텍스트-투-비디오 작업은 Kling 3.0 Turbo 프롬프트 레시피 또는 위 참조 클립을 만드는 데 사용한 grok-imagine 텍스트-투-비디오 가이드를 참고하세요.
두 모델 모두 hiapi API에 출시되어 있으며 동일한 키로 사용할 수 있습니다—모델마다 별도 가입이 필요하지 않습니다.
관련 글
모든 아티클 보기 →-
사용 가이드
seedream-5.0-pro/image-to-image 시작 가이드: 기능, 가격 및 연동 핵심 포인트
ByteDance 이미지 편집 모델의 기능 경계, 과금 방식 및 엔지니어링 연동 실무
-
사용 가이드
seedream-5.0-pro 텍스트-이미지 생성 입문 가이드: 능력 경계, API 연동 및 비용 관리
개발자를 위한 실무 관점: 파라미터 핵심부터 장당 $0.05 비용 추정까지
-
사용 가이드
Hailuo 2.3 Fast 이미지-투-비디오 입문 가이드: 성능 범위, 가격 및 연동 실무
개발자를 위한 MiniMax 이미지-투-비디오 모델 선택과 연동 핵심 포인트