Kling 4.0 API

Kuaishou의 Kling 4.0 동영상 생성 모델에 대한 종합 API 참조 문서입니다.

모델 종류

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

빠른 비교

지원하는 화면 비율

Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit는 다음 화면 비율을 지원합니다.

16:9, 9:16, 1:1, 21:9

기본값은 16:9입니다. Video Extend는 aspect_ratio 매개변수를 지원하지 않으며, 출력은 원본 동영상의 화면 비율을 따릅니다.

해상도 옵션

다섯 모델 모두 resolution과 duration이 필수입니다. resolution의 기본값이 720p이더라도 명시적으로 포함해야 합니다. duration에는 기본값이 없습니다.

Kling 4.0 Text to Video

엔드포인트 {#}

POST /api/v1/video/task

요청 매개변수

필수

선택

요청 예시

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-v4.0-text-to-video',
    prompt: 'A drone flying over a mountain range at sunrise, smooth forward camera movement',
    resolution: '720p',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

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

Kling 4.0 Image to Video

요청 매개변수

필수

선택

image_url과 image_end_url을 모두 제공하면 key_frames에 최대 8개의 이미지를 포함할 수 있습니다. 중간 프레임은 배열 순서대로 사용되며 각 프레임의 시점은 모델이 결정합니다.

요청 예시

javascript복사
{
  model_name: 'kling-v4.0-image-to-video',
  prompt: 'Camera slowly pulls back from the character to reveal the surrounding mountain landscape',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  key_frames: [
    'https://example.com/middle-frame-1.jpg',
    'https://example.com/middle-frame-2.jpg'
  ],
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Reference to Video

요청 매개변수

필수

선택

참조 이미지, 동영상, 오디오는 모두 선택 사항입니다. 한 가지 미디어 유형만 제공하거나, 여러 유형을 조합하거나, 세 가지 모두 생략할 수 있습니다.

출력 duration은 3~30초 범위에서 독립적으로 설정하며 참조 동영상의 총길이 제한에 포함되지 않습니다.

요청 예시

javascript복사
{
  model_name: 'kling-v4.0-reference-to-video',
  prompt: 'Use the character from the reference image, follow the camera movement in the reference video, and use the reference audio for voice guidance',
  images: ['https://example.com/character-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  keep_original_sound: false,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Edit

요청 매개변수

필수

선택

요청 예시

javascript복사
{
  model_name: 'kling-v4.0-video-edit',
  prompt: 'Replace the background with warm sunset colors while preserving the subject and camera movement',
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/sunset-reference.jpg'],
  keep_original_sound: true,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Extend

요청 매개변수

필수

선택

aspect_ratio를 전송하지 마세요. 출력은 원본 동영상의 화면 비율을 따릅니다. 결과에는 원본과 연장 구간을 포함한 전체 동영상이 반환됩니다. 총길이는 원본 동영상 길이에 duration을 더한 값입니다.

요청 예시

javascript복사
{
  model_name: 'kling-v4.0-video-extend',
  prompt: 'Continue the camera movement forward through the valley as the sun rises above the mountains',
  video_url: 'https://example.com/source.mp4',
  image_end_url: 'https://example.com/target-end-frame.jpg',
  resolution: '720p',
  duration: 5
}

과금 규칙

Text-to-Video와 Image-to-Video는 출력 해상도와 생성된 동영상 길이에 따라 과금됩니다. Video Extend는 반환된 전체 동영상 길이가 아니라 해상도와 추가 구간의 길이에 따라 과금됩니다.

참조 동영상을 포함하는 Reference-to-Video 요청과 Video Edit 요청은 선택한 해상도에서 입력 및 출력 동영상 길이를 모두 과금에 반영합니다. 입력 동영상의 과금 대상 시간은 최소 3초, 최대 30초입니다. 참조 동영상이 여러 개인 경우 이 범위는 각 동영상에 개별적으로 적용되는 것이 아니라 합산 길이에 적용됩니다. 과금 대상 시간의 범위가 업로드 제한을 정하는 것은 아닙니다.

참조 동영상이 없으면 Reference-to-Video에는 참조 이미지나 오디오 제공 여부와 관계없이 Text-to-Video와 동일한 과금 규칙이 적용됩니다. 동영상 입력이 있는 요청에서 지원되는 참조 이미지, 참조 오디오, keep_original_sound에는 별도 요금이 추가되지 않습니다.

응답 형식

초기 응답

모든 모델은 폴링에 사용할 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. 필수 매개변수: 항상 resolution과 duration을 제공하세요. 기본 해상도인 720p를 사용하는 경우에도 필수입니다
2. 프레임 수: 첫 프레임, 마지막 프레임, 중간 프레임의 합계를 10개 이하로 유지하세요
3. 참조 미디어: 참조 미디어의 개수와 길이를 문서에 명시된 범위 이내로 유지하세요
4. 원본 사운드: keep_original_sound는 Reference-to-Video 또는 Video Edit에서만 사용하세요
5. 동영상 연장: duration을 추가할 길이로 설정하고 aspect_ratio는 생략하세요