model: kling-v2-6-motion을 제출하고 반환된 img_uuid를 저장한 다음, 비동기 완료를 위해 폴링하거나 콜백을 사용하세요.캐릭터 중심 비디오를 위한 Kling 2.6 모션 컨트롤 API
하나의 캐릭터 외형 이미지와 하나의 모션 참조 비디오를 사용하여 GoEnhance를 통해 Kling 2.6 모션 컨트롤에 액세스하세요.
API 키 받기
외형과 연속적인 모션 결합
하나의 이미지로 캐릭터 정의
image_url을 통해 필수 JPG, JPEG 또는 PNG 파일을 제공하세요. 파일은 최대 50MB까지 가능하며, 각 변은 최소 300px 이상이어야 하고, 캐릭터의 머리와 상반신 또는 전신이 명확하게 보이는 1:2.5에서 2.5:1 사이의 종횡비가 필요합니다.
참조 비디오에서 모션 전송
video_url을 통해 필수 MP4 또는 MOV 파일을 제공하세요. character_orientation을 사용하여 출력물이 모션 비디오를 향할지 아니면 외형 이미지를 향할지 선택하세요. 해당 설정은 30초 또는 10초의 입력 제한도 결정합니다.
제출 전 두 참조 파일의 유효성을 검사하고 지원되지 않는 지속 시간 또는 4K 필드를 생략하세요.
Kling 2.6 모션 컨트롤 API 기능
정확한 모델 ID
<code>model</code>을 <code>kling-v2-6-motion</code>으로 설정하여 <code>https://api.goenhance.ai/api/v1/videos/generations</code>에 POST 요청을 보내세요.
필수 프롬프트
최대 2,500자까지의 필수 프롬프트에 외형 세부 정보나 의상을 설명하세요.
외형 이미지
하나의 필수 <code>image_url</code>을 사용하세요. Kling 2.6 모션 컨트롤은 3.0 모델의 요소 기반 외형 입력을 허용하지 않습니다.
모션 비디오
최대 100MB, 340px에서 3,850px 사이의 해상도와 연속적인 사용 가능한 모션을 가진 필수 MP4 또는 MOV 파일을 하나 사용하세요.
방향 제한
<code>video</code>가 기본값이며 3~30초를 허용합니다. <code>image</code>는 외형 이미지의 방향을 따르며 3~10초를 허용합니다.
해상도 및 사운드
720p 또는 1080p를 선택하세요. 4K 등급은 없습니다. <code>generate_audio</code>는 모션 비디오의 원본 사운드트랙을 유지할 수 있지만, 네이티브 오디오를 생성하지는 않습니다.
측정된 모션 비디오 초 단위에 정확한 해상도 비율을 곱하여 최대 요청 비용을 산정하십시오.
Kling 2.6 모션 컨트롤 API 가격
720p 가격
생성된 초당 3.5 토큰이며, 문서화된 토큰당 $0.02 환율 기준으로 초당 $0.07에 해당합니다.
1080p 가격
생성된 초당 5.6 토큰이며, 문서화된 토큰당 $0.02 환율 기준으로 초당 $0.112에 해당합니다.
측정된 지속 시간 기반 청구
GoEnhance는 먼저 <code>video_url</code>을 복사 및 측정하고, 해당 측정된 입력 지속 시간을 상한선으로 청구합니다. Kling은 생성된 출력 길이를 기준으로 청구하며, 모션을 연속적으로 추출할 수 없는 경우 출력 길이가 더 짧아질 수 있습니다.
6단계로 모션 컨트롤 통합하기
1
1. API 키 생성
GoEnhance API 키를 생성하고 인증된 요청과 함께 전송하십시오.
2
2. 외형 이미지 검증
형식, 파일 크기, 픽셀 치수, 가로세로 비율, 가시성, 그리고 머리와 몸이 가려지지 않은 프레임 구성을 확인하십시오.
3
3. 모션 비디오 검증
MP4 또는 MOV 형식, 100MB 제한, 픽셀 범위, 그리고 방향별 지속 시간인 3~30초 또는 3~10초를 확인하십시오.
4
4. 생성 제출
모델 ID, 프롬프트,
image_url, video_url, 방향, 해상도 및 선택적 콜백 URL을 POST 방식으로 전송하십시오. 5
5. 작업 ID 유지
수락된 응답에서
data.img_uuid를 저장하고 이를 영구적인 작업 식별자로 사용하십시오. 6
6. 최종 상태 추적
GET /api/v1/jobs/detail을 폴링하거나 처리 중, 성공, 실패 상태에 대한 콜백 업데이트를 멱등성 있게 처리하십시오.특히 원본 오디오를 유지할 때는 처리 권한이 있는 외형 및 모션 에셋만 사용하십시오.
모션 제어 비디오를 위한 개발자 사용 사례
캐릭터 퍼포먼스 파이프라인
검토 가능한 숏폼 비디오 제작을 위해 승인된 모션 레퍼런스를 일관된 캐릭터 이미지에 적용하십시오.
댄스 및 안무 콘셉트
애플리케이션 수준의 검토 단계를 유지하면서 라이선스가 있거나 원본인 모션 영상으로부터 움직임 중심의 클립을 프로토타이핑하십시오.
제품 마스코트 애니메이션
캠페인 변형을 위해 제어된 모션 레퍼런스를 사용하여 명확하게 프레이밍된 마스코트 또는 대변인 이미지를 애니메이션화하십시오.
가격, 필수 입력 사항, 소요 시간, 사운드, 콜백 및 Kuaishou API 의도에 대한 실용적인 답변입니다.