model: kling-v3-motion으로 Kling V3 모션 제어에 액세스하세요. 외형 및 모션 참조를 제공하고, 하나의 비동기 요청을 제출한 뒤 폴링 또는 콜백을 통해 반환된 img_uuid를 추적하세요.참조 기반 캐릭터 비디오를 위한 Kling V3 모션 제어 API
GoEnhance를 통해
API 키 받기
하나의 요청으로 외형 및 모션 참조 결합
제출 전 미디어를 검증하세요. 지원되지 않는 길이 또는 해상도 값은 클라이언트 측에서 거부되어야 합니다.
Kling V3 모션 제어 API 기능 및 검증 규칙
엔드포인트 및 모델
<code>model: kling-v3-motion</code>과 함께 <code>https://api.goenhance.ai/api/v1/videos/generations</code>로 POST 요청을 보내세요.
프롬프트
캐릭터, 의상, 장면 또는 관련 생성 방향을 설명하기 위해 최대 2,500자까지 필수 <code>prompt</code>를 전송하세요.
외형 입력
<code>image_url</code>은 JPG, JPEG 또는 PNG 형식이어야 하며, 최대 50MB, 각 변 최소 300px, 가로세로 비율 1:2.5에서 2.5:1 사이여야 합니다.
모션 입력
필수 <code>video_url</code>은 MP4 또는 MOV 형식이어야 하며, 최대 100MB, 크기는 340px에서 3,850px 사이여야 합니다.
방향 및 길이
<code>character_orientation: video</code>는 3~30초를 허용하며, <code>image</code>는 3~10초를 허용합니다. 문서화된 기본값은 <code>video</code>입니다.
해상도 및 오디오
720p 또는 1080p를 선택하세요. 4K 등급은 없습니다. <code>generate_audio</code>는 모션 비디오의 원본 사운드를 유지하며 기본값은 false입니다.
가격은 생성된 초 단위로 책정되며, GoEnhance는 요청의 상한선 비용으로 입력 모션 영상 길이를 측정합니다.
Kling V3 동작 제어 API 가격
720p 요금
생성된 초당 6.3 토큰으로, 문서화된 토큰당 $0.02 기준으로 초당 $0.126에 해당합니다.
1080p 요금
생성된 초당 8.4 토큰으로, 문서화된 토큰당 $0.02 기준으로 초당 $0.168에 해당합니다.
비용 추정
측정된 모션 비디오 길이에 선택한 해상도의 정확한 요금을 곱하여 요청 비용의 상한선을 추정하세요.
측정된 입력 기반 과금
GoEnhance는 토큰을 차감하기 전에 <code>video_url</code>을 전송하고 측정하므로, 측정 후 원격 파일을 변경해도 청구되는 입력 비용은 변하지 않습니다.
출력물이 더 짧을 수 있음
Kling은 사용 가능한 연속 동작을 추출하므로, 동작이 어렵거나 매우 빠른 경우 참조 영상보다 짧은 출력물이 생성될 수 있습니다.
지속 시간 매개변수 없음
<code>duration</code>을 보내지 마십시오. 엔드포인트에서 이를 거부하며, 출력 길이는 참조 영상에서 추출된 사용 가능한 동작에 따라 결정됩니다.
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을 저장하십시오.
처리 권한이 있는 미디어를 사용하고 비동기 완료를 위해 설계하십시오.
Kling V3 Motion Control 개발자 사용 사례
캐릭터 연기 클립
짧은 내러티브 또는 홍보 영상 파이프라인을 위해 일관된 캐릭터 외형에 승인된 동작 참조를 적용하십시오.
댄스 및 안무 미리보기
동의 및 원본 오디오 권리를 보존하면서 라이선스가 부여된 리허설 동작을 캐릭터 중심의 미리보기로 전송하십시오.
게임 캐릭터 애니메이션 콘셉트
전체 애니메이션 워크플로우를 확정하기 전에 캐릭터 아트와 녹화된 동작에서 모션 스터디를 생성하십시오.
현지화된 캠페인 변형
단일 작업 오케스트레이션 계층을 재사용하면서 지역별 크리에이티브 변형을 위해 프롬프트와 외형 입력을 매개변수화하십시오.
가상 연기자 워크플로우
승인된 이미지 참조, 모션 에셋 및 방향 설정을 중심으로 제어 가능한 연기자 파이프라인을 구축하십시오.
사전 시각화
다운스트림 편집, 합성 및 검토 전에 모션 참조가 캐릭터에 적합한지 테스트하십시오.
통합, 가격 책정, 검증 및 Kuaishou API 관련 자주 묻는 질문에 대한 답변입니다.