아티클 목록으로
Hypereal AI Team
APITutorialVideo Generation
Kling V2.6 Pro Motion Control API: 모든 피사체에 동작 적용하기
6 min read
100개 이상의 AI 모델, 하나의 API
Hypereal로 구축 시작하기
단일 API를 통해 Kling, Flux, Sora, Veo 등에 액세스하세요. 무료 크레딧으로 시작하고 수백만으로 확장하세요.
신용카드 불필요 • 10만 명 이상의 개발자 • 엔터프라이즈 지원
Kling Motion Control API란 무엇인가요?
Kling V2.6 Pro Motion Control API를 사용하면 레퍼런스 비디오의 동작을 대상 이미지로 전송하여 역동적인 비디오 콘텐츠를 제작할 수 있습니다. 이 강력한 API는 정지 이미지와 동작 레퍼런스 비디오를 입력받아, 레퍼런스의 움직임에 맞춰 대상을 애니메이션화합니다.
주요 활용 사례
- 댄스 비디오: 어떤 캐릭터에게든 댄스 안무를 적용
- 제품 애니메이션: 정적인 제품 이미지에 역동적인 움직임을 부여
- 캐릭터 애니메이션: 레퍼런스 동작을 활용해 일러스트나 사진을 애니메이션화
- 소셜 미디어 콘텐츠: 정지 이미지로부터 몰입감 있는 애니메이션 콘텐츠 제작
API 파라미터
필수 파라미터 (Required Parameters)
| 파라미터 | 타입 | 설명 |
|---|---|---|
image |
string | 대상 이미지 URL (jpg/png, 최대 10MB, 최소 300px, 종횡비 1:2.5 ~ 2.5:1) |
video |
string | 동작 레퍼런스 비디오 URL (mp4/mov, 최대 10MB, 최소 300px, 종횡비 1:2.5 ~ 2.5:1) |
character_orientation |
string | 출력 프레이밍 설정: "image" 또는 "video" |
선택 파라미터 (Optional Parameters)
| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
prompt |
string | — | 생성 가이드를 위한 긍정 프롬프트 |
negative_prompt |
string | — | 제외할 요소 (최대 2,500자) |
keep_original_sound |
boolean | true |
레퍼런스 비디오의 오디오 유지 여부 |
가격 정책
| 재생 시간 | 가격 (USD) | 크레딧 |
|---|---|---|
| 5초 | $0.56 | ~96 |
| 10초 | $1.12 | ~192 |
| 15초 | $1.68 | ~288 |
| 30초 | $3.36 | ~576 |
Kling Motion Control API 사용 방법
1단계: 계정 생성
Hypereal에서 가입하여 Kling Motion Control API 사용을 시작하세요.
2단계: API 키 발급
대시보드에서 API 키를 생성합니다. 키를 안전하게 보관하고 클라이언트 측 코드에 노출되지 않도록 주의하세요.
3단계: API 호출
const response = await fetch('https://api.hypereal.com/v1/videos/generate', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'kling-2-6-motion-control',
image: 'https://example.com/subject.jpg',
video: 'https://example.com/motion-reference.mp4',
character_orientation: 'image',
prompt: 'Smooth, natural movement',
negative_prompt: 'blurry, distorted, artifacts',
keep_original_sound: true
})
});
const result = await response.json();
console.log(result);
4단계: 응답 처리
if (result.status === 'completed') {
console.log('Video URL:', result.outputs[0]);
} else if (result.status === 'processing') {
// task ID를 사용하여 완료 여부 폴링(Polling)
console.log('Task ID:', result.id);
} else {
console.error('Error:', result.error);
}
권장 모범 사례 (Best Practices)
- 종횡비 일치 - 최상의 결과를 위해 이미지와 비디오에 유사한 종횡비를 사용하세요.
- 고품질 입력물 - 소스 자료의 품질이 높을수록 결과물의 완성도가 높아집니다.
- 명확한 피사체 - 이미지 속의 피사체가 명확하게 보이도록 하세요.
- 적절한 동작 선택 - 피사체에 적합한 움직임이 담긴 레퍼런스 비디오를 선택하세요.
- 프롬프트 활용 - 스타일과 품질을 가이드하기 위해 프롬프트를 적절히 추가하세요.
자주 묻는 질문 (FAQ)
지원되는 파일 형식은 무엇인가요?
- 이미지: JPG, PNG (최대 10MB)
- 비디오: MP4, MOV (최대 10MB)
character_orientation이란 무엇인가요?
이 파라미터는 출력 비디오의 프레이밍이 대상 이미지의 구도를 따를지, 레퍼런스 비디오의 구도를 따를지 제어합니다.
오디오를 유지할 수 있나요?
네, keep_original_sound: true로 설정하면 레퍼런스 비디오의 오디오 트랙을 보존할 수 있습니다.
영상 길이는 최대 얼마인가요?
출력 비디오는 레퍼런스 비디오의 길이에 따라 5, 10, 15 또는 30초로 제작 가능합니다.
왜 Hypereal에서 Kling Motion Control API를 사용해야 하나요?
단일 통합 API를 통해 Kling Motion Control을 포함한 100개 이상의 AI 모델을 이용할 수 있습니다. 다음과 같은 혜택을 제공합니다:
- 모든 모델에 대해 하나의 API 키 사용
- 여러 제공업체에 걸친 통합 결제 시스템
- 대량 구매 할인이 적용된 경쟁력 있는 가격
- 상세한 문서 및 기술 지원
무료로 시작하기 - 신용카드 정보가 필요하지 않습니다.
