메인 콘텐츠로 건너뛰기
POST
AIReiter에서 Kling 4.0의 모델 이름은 kling_v4입니다. type을 사용하여 생성 모드를 선택하며, 모드에 따라 지원하는 에셋이 다릅니다. 아래 모드 파라미터 비교를 참고하세요.최종 영상에는 항상 스테레오 오디오 트랙이 포함되며 끌 수 없습니다. 4K, negative_prompt, seed는 지원하지 않습니다.

Authorizations

string
필수
모든 API는 Bearer Token을 통한 인증이 필요합니다.API Key 발급:API Key 관리 페이지에 접속하여 API Key를 발급받으세요.사용 시 요청 헤더에 추가:

Body

string
필수
모델 이름으로, kling_v4로 고정됩니다.
object
필수
모델 파라미터 객체입니다.
string
필수
요청자 작업 ID입니다.사용자 정의 작업 식별자로, 필수 항목입니다. 영문자, 숫자, 밑줄(_), 하이픈(-)만 지원하며 길이는 1-64자입니다. 추후 이 ID를 사용하여 작업 상태와 결과를 조회할 수 있습니다.

Response

string
요청자 작업 ID로, 결과 조회에 사용할 수 있습니다.
string
초기 상태로, 일반적으로 "pending"입니다.
string
생성 시간, ISO 형식입니다.

Query Task

Kling 4.0은 비동기 동영상 생성 모델입니다. 작업을 제출한 후 out_task_id를 사용하여 작업 상태를 조회하세요. 작업 상태 조회도 참조할 수 있습니다.
string
필수
작업 제출 시 전달한 요청자 작업 ID입니다.
조회가 성공하고 완료되면 응답의 output 배열에 생성된 동영상이 포함되며, 요소에는 video 필드가 포함됩니다. 생성 소요 시간은 모드와 길이에 따라 다릅니다: 1080p 5초 텍스트 투 비디오(Text-to-Video) 실측 약 4.5분이 소요되며, 길이가 길고 소재가 많을수록 소요 시간이 길어지므로 중복 제출하지 마시고 계속 폴링해 주세요.

模式参数对照

frame 모드에서 첫 프레임이 누락되거나 edit / extend 모드에서 원본 비디오가 누락된 경우 작업이 실패로 종료됩니다. 위 표에 따라 필수 에셋을 모두 전달해 주세요.

사용 안내

  • 프롬프트만 전달하면 텍스트 투 비디오(Text-to-Video)로 동작하며, 참조 소재를 전달하면 참조 생성으로 처리됩니다. aspect_ratio가 auto일 때는 소재의 비율을 따릅니다.
  • 비디오 연장은 하나의 완전한 파일로 반환됩니다. 원본 비디오가 앞에 위치하고 새로 추가된 세그먼트가 뒤에 이어집니다. 실제 테스트 결과 5초 원본 비디오를 5초 연장하면 10.0초 비디오가 반환되며, 해상도는 원본 비디오와 동일하고 연결 부위에 눈에 띄는 이음매가 없습니다.
  • 비디오 연장은 원본 비디오 부분의 오디오를 유지하며, 새로 추가된 세그먼트는 오디오가 자동으로 생성됩니다. 원본 비디오에 오디오가 없는 경우 이 부분은 계속 무음으로 유지됩니다.
  • 비디오 편집은 기본적으로 원본 비디오 오디오를 유지하며, 새로운 오디오가 필요한 경우 audio_setting: "auto"를 전달합니다.

Request Examples