참조 기반 캐릭터 비디오를 위한 Kling V3 모션 제어 API

GoEnhance를 통해 model: kling-v3-motion으로 Kling V3 모션 제어에 액세스하세요. 외형 및 모션 참조를 제공하고, 하나의 비동기 요청을 제출한 뒤 폴링 또는 콜백을 통해 반환된 img_uuid를 추적하세요.
API 키 받기
Kling V3 모션 제어 API를 위한 영화 같은 모션 참조 제작

하나의 요청으로 외형 및 모션 참조 결합

캐릭터의 외형 정의

선명한 상반신 또는 전신 캐릭터 이미지를 위해 image_url을 사용하거나, element_ids를 통해 최대 하나의 Kling 요소를 사용하세요. 요소 입력 시 character_orientation: video가 강제됩니다.
캐릭터 비디오 생성을 위한 제어된 외형 참조 사진

참조 비디오에서 모션 전송

video_url에 필수 MP4 또는 MOV 파일을 제공하세요. 출력물은 해당 파일의 연속적인 모션을 따르며, 이 엔드포인트에는 duration 매개변수가 없습니다.
모션 참조로 사용되는 단일 장면 안무 리허설
제출 전 미디어를 검증하세요. 지원되지 않는 길이 또는 해상도 값은 클라이언트 측에서 거부되어야 합니다.

Kling V3 모션 제어 API 기능 및 검증 규칙

엔드포인트 및 모델

model: kling-v3-motion과 함께 https://api.goenhance.ai/api/v1/videos/generations로 POST 요청을 보내세요.

프롬프트

캐릭터, 의상, 장면 또는 관련 생성 방향을 설명하기 위해 최대 2,500자까지 필수 prompt를 전송하세요.

외형 입력

image_url은 JPG, JPEG 또는 PNG 형식이어야 하며, 최대 50MB, 각 변 최소 300px, 가로세로 비율 1:2.5에서 2.5:1 사이여야 합니다.

모션 입력

필수 video_url은 MP4 또는 MOV 형식이어야 하며, 최대 100MB, 크기는 340px에서 3,850px 사이여야 합니다.

방향 및 길이

character_orientation: video는 3~30초를 허용하며, image는 3~10초를 허용합니다. 문서화된 기본값은 video입니다.

해상도 및 오디오

720p 또는 1080p를 선택하세요. 4K 등급은 없습니다. generate_audio는 모션 비디오의 원본 사운드를 유지하며 기본값은 false입니다.
가격은 생성된 초 단위로 책정되며, GoEnhance는 요청의 상한선 비용으로 입력 모션 영상 길이를 측정합니다.

Kling V3 동작 제어 API 가격

720p 요금

생성된 초당 6.3 토큰으로, 문서화된 토큰당 $0.02 기준으로 초당 $0.126에 해당합니다.

1080p 요금

생성된 초당 8.4 토큰으로, 문서화된 토큰당 $0.02 기준으로 초당 $0.168에 해당합니다.

비용 추정

측정된 모션 비디오 길이에 선택한 해상도의 정확한 요금을 곱하여 요청 비용의 상한선을 추정하세요.

측정된 입력 기반 과금

GoEnhance는 토큰을 차감하기 전에 video_url을 전송하고 측정하므로, 측정 후 원격 파일을 변경해도 청구되는 입력 비용은 변하지 않습니다.

출력물이 더 짧을 수 있음

Kling은 사용 가능한 연속 동작을 추출하므로, 동작이 어렵거나 매우 빠른 경우 참조 영상보다 짧은 출력물이 생성될 수 있습니다.

지속 시간 매개변수 없음

duration을 보내지 마십시오. 엔드포인트에서 이를 거부하며, 출력 길이는 참조 영상에서 추출된 사용 가능한 동작에 따라 결정됩니다.

6단계로 Kling V3 Motion Control 통합하기

1

1. API 키 생성

GoEnhance API 키를 생성하고 Authorization 헤더에 포함하여 전송하십시오.
2

2. 두 참조 모두 검증

이미지의 선명도와 크기를 확인한 다음, 모션 영상의 형식, 크기, 치수 및 방향에 따른 길이를 검증하십시오.
3

3. 작업 제출 및 유지

model: kling-v3-motion으로 요청을 POST하고, 백그라운드 프로세서에 작업을 넘기기 전에 반환된 img_uuid를 저장하십시오.
4

4. 상태 추적

GET /api/v1/jobs/detail을 폴링하거나 공개적으로 액세스 가능한 HTTPS custom_callback_url을 제공하십시오.
5

5. 멱등성 있는 콜백 처리

반복되는 상태 이벤트를 안전하게 처리하십시오. HTTP 200을 반환하지 않는 콜백은 시도당 3초의 타임아웃으로 최대 3회까지 재시도될 수 있습니다.
6

6. 최종 결과 저장

처리, 성공 및 실패 처리를 분리하고 작업이 최종 상태에 도달한 후에만 최종 영상 URL을 저장하십시오.
API 키 가져오기
처리 권한이 있는 미디어를 사용하고 비동기 완료를 위해 설계하십시오.

Kling V3 Motion Control 개발자 사용 사례

캐릭터 연기 클립

짧은 내러티브 또는 홍보 영상 파이프라인을 위해 일관된 캐릭터 외형에 승인된 동작 참조를 적용하십시오.

댄스 및 안무 미리보기

동의 및 원본 오디오 권리를 보존하면서 라이선스가 부여된 리허설 동작을 캐릭터 중심의 미리보기로 전송하십시오.

게임 캐릭터 애니메이션 콘셉트

전체 애니메이션 워크플로우를 확정하기 전에 캐릭터 아트와 녹화된 동작에서 모션 스터디를 생성하십시오.

현지화된 캠페인 변형

단일 작업 오케스트레이션 계층을 재사용하면서 지역별 크리에이티브 변형을 위해 프롬프트와 외형 입력을 매개변수화하십시오.

가상 연기자 워크플로우

승인된 이미지 참조, 모션 에셋 및 방향 설정을 중심으로 제어 가능한 연기자 파이프라인을 구축하십시오.

사전 시각화

다운스트림 편집, 합성 및 검토 전에 모션 참조가 캐릭터에 적합한지 테스트하십시오.
통합, 가격 책정, 검증 및 Kuaishou API 관련 자주 묻는 질문에 대한 답변입니다.

Kling V3 모션 제어 API FAQ

Kling V3 동작 제어 API 엔드포인트란 무엇인가요?

model: kling-v3-motion과 함께 POST https://api.goenhance.ai/api/v1/videos/generations를 통해 GoEnhance로 제출하십시오. 응답으로 img_uuid가 반환됩니다.

Kling V3 동작 제어 API 가격은 어떻게 책정되나요?

720p는 초당 6.3 토큰($0.126/초), 1080p는 초당 8.4 토큰($0.168/초)의 비용이 발생합니다. GoEnhance는 요청의 최대 청구 금액을 결정하기 위해 차감 전 모션 비디오의 길이를 측정합니다.

길이(duration) 매개변수를 보낼 수 있나요?

아니요. 이 엔드포인트는 duration을 허용하지 않습니다. 참조 비디오는 방향별 제한 사항을 충족해야 하며, 출력물은 참조 비디오에서 추출된 사용 가능한 연속 모션을 따릅니다.

character_orientation은 무엇을 변경하나요?

video는 모션 비디오의 방향을 따르며 3~30초까지 허용됩니다. image는 외형 이미지를 따르며 3~10초까지 허용됩니다.

API로 네이티브 오디오를 생성할 수 있나요?

아니요. generate_audio는 모션 비디오의 원본 사운드트랙만 유지합니다. 기본값은 false이며, 필요한 권한이 있는 경우에만 오디오를 사용하세요.

이미지 대신 Kling 요소를 사용할 수 있나요?

V3 경로는 element_ids(또는 단일 값 별칭 element_id)를 통해 최대 하나의 값을 허용합니다. 요소 입력 시 character_orientation: video가 강제됩니다.

콜백은 어떻게 작동하나요?

공용 HTTPS custom_callback_url을 제공하세요. 콜백 본문은 작업 상세 응답과 일치하며, 200 이외의 응답이 발생할 경우 3초 타임아웃으로 최대 3회까지 재시도될 수 있습니다.

이것이 Kuaishou의 공식 API인가요?

아니요. Kling은 Kuaishou와 관련이 있지만, 이 페이지는 GoEnhance를 통한 독립적인 액세스 방법을 설명합니다. GoEnhance는 Kuaishou나 Kling의 공식 API, 파트너 또는 모델 개발자로 제공되지 않습니다.

Kling V3 모션 제어 API로 빌드하기