Kling 2.6 Motion Control API

Kuaishou의 Kling 2.6 Motion Control 동영상 생성을 위한 전체 API 참조 문서입니다.

모델 종류

이 API는 한 가지 모델을 지원합니다.

Kling 2.6 Motion Control

엔드포인트 {#}

POST /api/v1/video/task

요청 매개변수

필수

선택

출력 길이는 원본 동영상을 따릅니다. duration 매개변수는 지원되지 않습니다. 출력 화면 비율은 입력 미디어에 따라 결정되며, aspect_ratio는 지원되지 않습니다. 상위 제공업체는 어떤 입력이 출력 화면 비율을 결정하는지 또는 정확한 선택 규칙이 무엇인지 명시하지 않았습니다.

요금은 원본 동영상 길이를 가장 가까운 정수 초로 반올림한 값과 선택한 출력 해상도를 기준으로 계산됩니다. 예를 들어 5.4초는 5초로, 5.5초는 6초로 과금됩니다.

요청 예시

예시 미디어 URL을 위 요구 사항을 충족하는 본인 파일의 URL로 교체하세요.

javascript복사
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-2.6-motion-control',
    prompt: 'Animate the character in the reference image using the dance movements from the reference video',
    images: ['https://example.com/character.jpg'],
    videos: ['https://example.com/dance-reference.mp4'],
    character_orientation: 'video',
    resolution: '720p',
    keep_original_sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

응답 형식

초기 응답

폴링에 사용할 task_id를 반환합니다.

json복사
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

GET /api/v1/video/{task_id}로 폴링하여 상태를 확인하고 생성된 동영상을 가져옵니다.

상태 값

• submitted: 작업이 접수되어 처리를 기다리는 중
• processing: 동영상 생성 중
• succeed: 동영상 생성 완료
• failed: 동영상 생성 실패

권장 사항

1. 참조 미디어: 이미지 1장과 동영상 1개를 정확히 제공하고, 제출 전에 형식, 파일 크기, 너비와 높이를 확인하세요
2. 방향: character_orientation을 변경할 때, 특히 "image"를 선택할 때는 참조 동영상의 길이를 다시 확인하세요
3. 원본 사운드: 참조 동영상의 원본 사운드를 유지하지 않으려면 keep_original_sound를 false로 설정하세요. 이 항목을 생략하면 사운드가 유지됩니다